O método JavaScript String indexOf () retorna o primeiro índice de ocorrência de um determinado valor na string, ou -1 se não estiver presente.
A sintaxe do indexOf()
método é:
str.indexOf(searchValue, fromIndex)
Aqui, str é uma string.
Parâmetros indexOf ()
O indexOf()
método inclui:
- searchValue - O valor a ser pesquisado na string. Se nenhuma string for fornecida explicitamente, "undefined" será pesquisado.
- fromIndex (opcional) - O índice no qual iniciar a pesquisa. Por padrão, é 0 . Se fromIndex <0 , a pesquisa começa no índice 0 .
Valor de retorno de indexOf ()
- Retorna o primeiro índice do valor na string se estiver presente pelo menos uma vez.
- Retorna -1 se o valor não for encontrado na string.
Observação: o indexOf()
método diferencia maiúsculas de minúsculas.
Para string vazia searchValue e fromIndex menor que o comprimento da string, indexOf
retorna o valor igual a fromIndex.
Da mesma forma, para string vazia searchValue e fromIndex maior que o comprimento da string, indexOf
retorna o comprimento da string.
"Programiz JavaScript".indexOf("", 0); // returns 0 "Programiz JavaScript".indexOf("", 3); // returns 3 // string length here is 20 "Programiz JavaScript".indexOf("", 25); // returns 20 "Programiz JavaScript".indexOf("", 21); // returns 20
Exemplo 1: Usando o método indexOf ()
var str = "JavaScript is the world's most misunderstood programming language."; // indexOf() returns the first occurance var index1 = str.indexOf("language"); console.log(index1); // 57 var index2 = str.indexOf("p"); console.log(index2); // 8 // second argument specifies the search's start index var index3 = str.indexOf("p", 9); console.log(index3); // 45 // indexOf returns -1 if not found var index4 = str.indexOf("Python"); console.log(index4); // -1
Resultado
57 8 45 -1
Exemplo 2: Encontrando todas as ocorrências de um elemento
function findAllIndex(string, value) ( indices = (); var currentIndex = string.indexOf(value); while (currentIndex != -1) ( indices.push(currentIndex); currentIndex = string.indexOf(value, currentIndex + value.length); ) return indices; ) var str = "JavaScript is as related to Java as Carpenter is to Carpet."; var occurance1 = findAllIndex(str, "J"); console.log(occurance1); // ( 0, 28 ) var occurance2 = findAllIndex(str, "Carpet"); console.log(occurance2); // ( 52 ) var occurance3 = findAllIndex(str, "x"); console.log(occurance3); // ()
Resultado
(0, 28) (52) ()
Leituras recomendadas:
- String JavaScript
- JavaScript String.lastIndexOf ()