Partilhar via

array_iff()

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

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

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

Sintaxe

array_iff( condition_array, when_truewhen_false)

Saiba mais sobre convenções de sintaxe.

Parâmetros

Nome Tipo Obrigatório 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 é falsa.

Observação

  • O comprimento do valor de retorno é o mesmo que o condition_array de entrada.
  • Os valores da 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 booleana são nulos no índice correspondente do valor de retorno.
  • 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ção.

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)

Realização

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 booleanos.

Executar a consulta

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

Realização

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 booleanos.

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)

Realização

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)

Realização

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

Conteúdo relacionado

  • Last updated on