Partilhar via

indexof()

  • Artigo

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

Relata o índice baseado em zero da primeira ocorrência de uma cadeia de caracteres especificada dentro da cadeia de caracteres de entrada.

Para obter mais informações, consulte indexof_regex().

Sintaxe

indexof(Ocorrência de comprimento[,inicial[,de correspondência[,de string,]]])

Saiba mais sobre as convenções de sintaxe.

Parâmetros

Nome Digitar Obrigatória Descrição
cadeia de caracteres string ✔️ A cadeia de caracteres de origem a ser pesquisada.
match string ✔️ A cadeia de caracteres para a qual pesquisar.
start int A posição inicial da pesquisa. Um valor negativo deslocará a posição inicial da pesquisa do final da cadeia de caracteres por estas várias etapas:abs( start).
length int O número de posições de caractere a serem examinadas. Um valor de -1 significa comprimento ilimitado.
occurrence int O número da ocorrência. O padrão é 1.

Observação

Se string ou match não for do tipo string, a função converte à força seu valor em string.

Devoluções

A posição de correspondência do índice com base em zero.

  • Retorna -1 se a correspondência não for encontrada na cadeia de caracteres.
  • Retorna null se:
    • start é menor que 0.
    • ocorrência é menor que 0.
    • comprimento é menor que -1.

Exemplos

print
 idx1 = indexof("abcdefg","cde")    // lookup found in input string
 , idx2 = indexof("abcdefg","cde",1,4) // lookup found in researched range 
 , idx3 = indexof("abcdefg","cde",1,2) // search starts from index 1, but stops after 2 chars, so full lookup can't be found
 , idx4 = indexof("abcdefg","cde",3,4) // search starts after occurrence of lookup
 , idx5 = indexof("abcdefg","cde",-5)  // negative start index
 , idx6 = indexof(1234567,5,1,4)       // two first parameters were forcibly casted to strings "12345" and "5"
 , idx7 = indexof("abcdefg","cde",2,-1)  // lookup found in input string
 , idx8 = indexof("abcdefgabcdefg", "cde", 1, 10, 2)   // lookup found in input range
 , idx9 = indexof("abcdefgabcdefg", "cde", 1, -1, 3)   // the third occurrence of lookup is not in researched range

Saída

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