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