Partilhar via

array_iff()

  • Artigo

Aplica-se a: ✅Microsoft Fabric✅Azure Data Explorer✅Azure Monitor✅Microsoft Sentinel

Função iif em elementos em matrizes dinâmicas.

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

Sintaxe

array_iff(condition_array, when_true, when_false)

Saiba mais sobre as convenções de sintaxe.

Parâmetros

Nome Digitar Obrigatória Descrição
condition_array dynamic ✔️ Uma matriz de valores booleanos ou numéricos.
when_true dinâmico ou escalar ✔️ Uma matriz de valores ou valor primitivo. Este será o resultado quando condition_array for verdadeira.
when_false dinâmico ou escalar ✔️ Uma matriz de valores ou valor primitivo. Este será o resultado quando condition_array for falso.

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éricos e não booleanos 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.

Devoluções

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

Exemplos

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
[verdadeiro, falso, verdadeiro] [1, 2, 3] [4, 5, 6] [1, 5, 3]

Valores de condição numérica

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 booleanos

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
[verdadeiro, falso, verdadeiro] 1 0 [nulo, nulo, nulo]

Comprimentos de matriz incompatíveis

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
[verdadeiro, verdadeiro, verdadeiro] [1, 2] [3, 4] [1, 2, nulo]