Partilhar via

array_index_of()

  • Artigo

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

Pesquisa uma matriz para o item especificado e retorna sua posição.

Sintaxe

array_index_of(valor da matriz, [, start [, comprimento [, ocorrência ]]])

Saiba mais sobre as convenções de sintaxe.

Parâmetros

Nome Digitar Obrigatória Descrição
array dynamic ✔️ A matriz a ser pesquisada.
value long, int, datetime, timespan, string, guid ou bool ✔️ O valor a ser pesquisado.
start int A posição inicial da pesquisa. Um valor negativo deslocará o valor de pesquisa inicial do final da matriz pelas abs(etapas iniciais) .
length int O número de valores a serem examinados. Um valor de -1 significa comprimento ilimitado.
occurrence int O número da ocorrência. O padrão é 1.

Devoluções

Retorna uma posição de pesquisa de índice com base em zero. Retorna -1 se o valor não for encontrado na matriz. Retorna null para entradas irrelevantes (ocorrência< 0 ou comprimento< -1).

Exemplo

O exemplo a seguir mostra o número da posição de palavras específicas dentro da matriz.

let arr=dynamic(["this", "is", "an", "example", "an", "example"]);
print
 idx1 = array_index_of(arr,"an")    // lookup found in input string
 , idx2 = array_index_of(arr,"example",1,3) // lookup found in researched range 
 , idx3 = array_index_of(arr,"example",1,2) // search starts from index 1, but stops after 2 values, so lookup can't be found
 , idx4 = array_index_of(arr,"is",2,4) // search starts after occurrence of lookup
 , idx5 = array_index_of(arr,"example",2,-1)  // lookup found
 , idx6 = array_index_of(arr, "an", 1, -1, 2)   // second occurrence found in input range
 , idx7 = array_index_of(arr, "an", 1, -1, 3)   // no third occurrence in input array
 , idx8 = array_index_of(arr, "an", -3)   // negative start index will look at last 3 elements
 , idx9 = array_index_of(arr, "is", -4)   // negative start index will look at last 3 elements

Saída

idx1 idx2 idx3 idx4 idx5 idx6 idx7 idx8 idx9
2 3 -1 -1 3 4 -1 4 -1

Conteúdo relacionado

Use set_has_element(arr, value) para verificar se existe um valor em uma matriz. Esta função melhorará a legibilidade da sua consulta. Ambas as funções têm o mesmo desempenho.