indexof()

Alterne os serviços usando a lista suspensa De versão . Saiba mais sobre navegação.
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. A função indexof() diferencia maiúsculas de minúsculas. Para executar uma pesquisa que não diferencia maiúsculas de minúsculas, considere usar tolower() ou toupper() em ambas as entradas.

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

Sintaxe

indexof( ,

Saiba mais sobre as convenções de sintaxe.

Parâmetros

Nome	Tipo	Obrigatória	Descrição
cadeia de caracteres	string	✔️	A cadeia de caracteres de origem a ser pesquisada.
fósforo	string	✔️	A cadeia de caracteres para a qual pesquisar.
começar	int		A posição inicial da pesquisa. Um valor negativo deslocará a posição inicial da pesquisa do final da cadeia de
comprimento	int		O número de posições de caractere a serem examinadas. Um valor de -1 significa comprimento ilimitado.
ocorrência	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

Executar a consulta

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