Partager via


array_iff()

S’applique à : ✅Microsoft Fabric

Fonction à l’échelle iif de l’élément sur les tableaux dynamiques.

Les fonctions et array_iff() les array_iif() fonctions sont équivalentes

Syntaxe

array_iff( condition_array, when_true, when_false)

En savoir plus sur les conventions de syntaxe.

Paramètres

Nom Catégorie Requise Descriptif
condition_array dynamic ✔️ Tableau de valeurs booléennes ou numériques.
when_true dynamique ou scalaire ✔️ Tableau de valeurs ou de valeurs primitives. C’est le résultat quand condition_array est vrai.
when_false dynamique ou scalaire ✔️ Tableau de valeurs ou de valeurs primitives. C’est le résultat quand condition_array est faux.

Remarque

  • La longueur de la valeur de retour est identique à la condition_array d’entrée.
  • Les valeurs de condition numérique sont considérées true si elles ne sont pas égales à 0.
  • Les valeurs de condition non numériques et non booléennes sont null dans l’index correspondant de la valeur de retour.
  • Si when_true ou when_false est plus court que condition_array, les valeurs manquantes sont traitées comme null.

Retours

Retourne un tableau dynamique des valeurs prises à partir de l’when_true ou des valeurs de tableau when_false, en fonction de la valeur correspondante du tableau de conditions.

Exemples

L’exemple suivant montre comment utiliser la array_iff() fonction pour évaluer des éléments dans un tableau.

print condition=dynamic([true,false,true]), if_true=dynamic([1,2,3]), if_false=dynamic([4,5,6]) 
| extend res= array_iff(condition, if_true, if_false)

Sortie

état if_true if_false Res
[true, false, true] [1, 2, 3] [4, 5, 6] [1, 5, 3]

L’exemple suivant montre comment les valeurs de condition numérique sont traitées comme des valeurs booléennes.

print condition=dynamic([1,0,50]), if_true="yes", if_false="no" 
| extend res= array_iff(condition, if_true, if_false)

Sortie

état if_true if_false Res
[1, 0, 50] Oui non [Oui, non, oui]

L’exemple suivant montre comment utiliser la array_iff() fonction avec des valeurs de condition non numériques et non booléennes.

print condition=dynamic(["some string value", datetime("01-01-2022"), null]), if_true=1, if_false=0
| extend res= array_iff(condition, if_true, if_false)

Sortie

état if_true if_false Res
[true, false, true] 1 0 [null, null, null]

L’exemple suivant montre comment la fonction gère les longueurs de tableau incompatibles.

print condition=dynamic([true,true,true]), if_true=dynamic([1,2]), if_false=dynamic([3,4]) 
| extend res= array_iff(condition, if_true, if_false)

Sortie

état if_true if_false Res
[true, true, true] [1, 2] [3, 4] [1, 2, null]