Compartilhar via

array_iff()

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

Função em termos de elemento iif 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. É o resultado quando condition_array é verdade.
when_false dinâmico ou escalar ✔️ Uma matriz de valores ou valor primitivo. É o resultado quando condition_array é falso.

Observação

  • O comprimento do valor retornado é 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.
  • Valores de condição não numéricos e não boolianos sã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

O exemplo a seguir mostra como usar a array_iff() função para avaliar elementos em uma matriz.

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

condição if_true if_false Res
[verdadeiro, falso, verdadeiro] [1, 2, 3] [4, 5, 6] [1, 5, 3]

O exemplo a seguir mostra como os valores de condição numérica são tratados como valores boolianos.

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

condição if_true if_false Res
[1, 0, 50] sim não [Sim, não, sim]

O exemplo a seguir mostra como usar a array_iff() função com 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

condição if_true if_false Res
[verdadeiro, falso, verdadeiro] 1 0 [nulo, nulo, nulo]

O exemplo a seguir mostra como a função lida com 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

condição if_true if_false Res
[verdadeiro, verdadeiro, verdadeiro] [1, 2] [3, 4] [1, 2, nulo]

Conteúdo relacionado