Remarque
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de vous connecter ou de modifier des répertoires.
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de modifier des répertoires.
Fonction à l’échelle iif de l’élément sur les tableaux dynamiques.
Les fonctions et
array_iff()lesarray_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
truesi 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] |