array_iff()

Learn how to use the array_iff() function to scan and evaluate elements in an array.

Element-wise iif function on dynamic arrays.

Syntax

array_iff(condition_array, when_true, when_false)

Parameters

NameTypeRequiredDescription
condition_arraydynamic✔️An array of boolean or numeric values.
when_truedynamic or scalar✔️An array of values or primitive value. This will be the result when condition_array is true.
when_falsedynamic or scalar✔️An array of values or primitive value. This will be the result when condition_array is false.

Returns

Returns a dynamic array of the values taken either from the when_true or when_false array values, according to the corresponding value of the condition array.

Examples

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)

Output

conditionif_trueif_falseres
[true, false, true][1, 2, 3][4, 5, 6][1, 5, 3]

Numeric condition values

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

Output

conditionif_trueif_falseres
[1, 0, 50]yesno[yes, no, yes]

Non-numeric and non-boolean condition values

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)

Output

conditionif_trueif_falseres
[true, false, true]10[null, null, null]

Mismatched array lengths

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)

Output

conditionif_trueif_falseres
[true, true, true][1, 2][3, 4][1, 2, null]