Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / Java

List.indexOf(Object) — indice della prima occorrenza

Trova la prima occorrenza di un elemento in una lista Java. Il risultato è un indice a partire da zero oppure `-1` se non ci sono corrispondenze.

Versione: Java SE 21

Sintassi

int indexOf(Object o)
int index = list.indexOf(value);

List.indexOf(Object) è un metodo dell’interfaccia java.util.List<E>. Riceve l’oggetto da cercare, non un indice, e non modifica la lista. Restituisce come int il più piccolo indice corrispondente: il primo elemento ha indice 0 e, se non ci sono corrispondenze, il risultato è -1.

La posizione i corrisponde se Objects.equals(o, list.get(i)) restituisce true. Due argomenti null sono considerati uguali; se o non è null, si usa il suo metodo equals. Non è quindi necessario che i riferimenti puntino allo stesso oggetto. Se la lista non ammette null, cercare null può restituire -1 o lanciare una NullPointerException. Se il tipo dell’argomento è incompatibile, l’implementazione può restituire -1 o lanciare una ClassCastException.

Verifica index >= 0 prima di passare il risultato a get: -1 non è un indice valido. In presenza di duplicati, usa lastIndexOf(Object) per trovare l’ultima occorrenza. Se ti interessa soltanto sapere se l’elemento è presente, usa contains(Object), che restituisce un boolean.

In molte implementazioni la ricerca è lineare e può richiedere di esaminare tutti gli elementi della lista.

Esempi

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));
        }
    }
}

Risultato

0
2
-1
red

`new String("red")` crea appositamente un oggetto distinto con lo stesso testo. La prima e l’ultima corrispondenza sono agli indici `0` e `2`; `"green"` dà `-1`. La condizione protegge la chiamata a `get`, il cui risultato viene stampato come `red`.

Lezioni correlate

  • Java · Lezione 54 · Base · Versione: 2

Fonti