CKTIS / Java
List.indexOf(Object) — índice da primeira ocorrência
Encontra a primeira ocorrência de um elemento numa lista Java. O resultado é um índice contado a partir de zero ou `-1` se não houver correspondência.
Versão: Java SE 21
Sintaxe
int indexOf(Object o)
int index = list.indexOf(value);List.indexOf(Object) é um método da interface java.util.List<E> que recebe o objeto a procurar, e não um índice. Não altera a lista. Devolve o menor índice que corresponde como int: o primeiro elemento tem índice 0 e, se não houver correspondência, o resultado é -1.
A posição i corresponde se Objects.equals(o, list.get(i)) devolver true. Dois argumentos null são considerados iguais; se o não for null, usa-se o seu método equals. Assim, as referências não têm de apontar para o mesmo objeto. Se a lista não aceitar null, procurar null pode devolver -1 ou lançar NullPointerException. Se o tipo do argumento for incompatível, a implementação pode devolver -1 ou lançar ClassCastException.
Verifica index >= 0 antes de passares o resultado a get: -1 não é um índice válido. Se houver duplicados e precisares da última ocorrência, usa lastIndexOf(Object). Se só quiseres saber se o elemento está presente, usa contains(Object), que devolve um boolean.
Em muitas implementações, a pesquisa é linear e pode ter de percorrer todos os elementos da lista.
Exemplos
import java.util.List;
public class Main {
public static void main(String[] args) {
List<String> colors = List.of("red", "blue", "red");
String target = new String("red");
int first = colors.indexOf(target);
System.out.println(first);
System.out.println(colors.lastIndexOf(target));
System.out.println(colors.indexOf("green"));
if (first >= 0) {
System.out.println(colors.get(first));
}
}
}Resultado
0 2 -1 red
`new String("red")` cria de propósito um objeto distinto com o mesmo texto. A primeira e a última correspondência estão em `0` e `2`; `"green"` dá `-1`. A condição protege a chamada a `get`, cujo resultado é apresentado como `red`.
Lições relacionadas
- Java · Lição 54 · Básico · Versão: 2