Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

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

Fontes