indexof()

Comunica o índice baseado em zero da primeira ocorrência de uma cadeia especificada na cadeia de entrada.

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

Syntax

indexof(cadeia de carateres,corresponder[,iniciar[,comprimento[,ocorrência]]])

Saiba mais sobre as convenções de sintaxe.

Parâmetros

Nome	Tipo	Necessário	Descrição
string	string	✔️	A cadeia de origem a procurar.
corresponder	string	✔️	A cadeia para a qual procurar.
iniciar	int		A posição de início da pesquisa. Um valor negativo irá compensar a posição de pesquisa inicial a partir do fim da cadeia por estes muitos passos: abs(iniciar).
length	int		O número de posições de carateres a examinar. Um valor de -1 significa comprimento ilimitado.
ocorrência	int		O número da ocorrência. A predefinição é 1.

Nota

Se cadeia ou correspondência não for do tipo string, a função força a converter o respetivo valor em string.

Devoluções

A posição de índice baseada em zero da correspondência.

• Devolve -1 se a correspondência não for encontrada na cadeia.
• Devolve null se:
  • iniciar é inferior a 0.
  • a ocorrência é inferior a 0.
  • o comprimento é inferior a -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