array_iff()

Função iif elemento a elemento em matrizes dinâmicas.

As array_iff() funções e array_iif() são equivalentes

Syntax

array_iff(condition_array, when_true, when_false)

Saiba mais sobre as convenções de sintaxe.

Parâmetros

Nome	Tipo	Obrigatório	Descrição
condition_array	dynamic	✔️	Uma matriz de valores boolianos ou numéricos.
when_true	dinâmico ou escalar	✔️	Uma matriz de valores ou valor primitivo. Esse será o resultado quando condition_array for verdadeiro.
when_false	dinâmico ou escalar	✔️	Uma matriz de valores ou valor primitivo. Esse será o resultado quando condition_array for false.

Observação

• O comprimento do valor retornado será o mesmo que o condition_array de entrada.
• Os valores de condição numérica são considerados true se não forem iguais a 0.
• Os valores de condição não numérica e não booliana serão nulos no índice correspondente do valor retornado.
• Se when_true ou when_false for menor que condition_array, os valores ausentes serão tratados como nulos.

Retornos

Retorna uma matriz dinâmica dos valores obtidos do when_true ou when_false valores de matriz, de acordo com o valor correspondente da matriz de condição.

Exemplos

Executar a consulta

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)

Saída

condition	if_true	if_false	res
[true, false, true]	[1, 2, 3]	[4, 5, 6]	[1, 5, 3]

Valores de condição numérica

Executar a consulta

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

Saída

condition	if_true	if_false	res
[1, 0, 50]	sim	não	[Sim, não, sim]

Valores de condição não numéricos e não boolianos

Executar a consulta

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)

Saída

condition	if_true	if_false	res
[true, false, true]	1	0	[null, null, null]

Comprimentos de matriz incompatíveis

Executar a consulta

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)

Saída

condition	if_true	if_false	res
[true, true, true]	[1, 2]	[3, 4]	[1, 2, nulo]