CKTIS / Java
List.indexOf(Object) — indice de la première occurrence
Trouvez la première occurrence d’un élément dans une liste Java. Le résultat est un indice compté à partir de zéro, ou `-1` si aucun élément ne correspond.
Version : Java SE 21
Syntaxe
int indexOf(Object o)
int index = list.indexOf(value);List.indexOf(Object) est une méthode de l’interface java.util.List<E>. Elle prend l’objet recherché, et non un indice, et ne modifie pas la liste. Elle renvoie le plus petit indice correspondant sous forme d’int : le premier élément a l’indice 0, et l’absence de correspondance donne -1.
La position i correspond si Objects.equals(o, list.get(i)) vaut true. Deux arguments null sont considérés comme égaux ; si o n’est pas null, la comparaison utilise sa méthode equals. Les références n’ont donc pas besoin de désigner le même objet. Si la liste n’accepte pas null, la recherche de null peut renvoyer -1 ou lever une NullPointerException. Si le type de l’argument est incompatible, l’implémentation peut renvoyer -1 ou lever une ClassCastException.
Vérifiez index >= 0 avant de passer le résultat à get : -1 n’est pas un indice valide. En présence de doublons, utilisez lastIndexOf(Object) pour trouver la dernière occurrence. Pour vérifier seulement si l’élément est présent, utilisez contains(Object), qui renvoie un boolean.
Dans de nombreuses implémentations, la recherche est linéaire et peut devoir examiner tous les éléments de la liste.
Exemples
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));
}
}
}Résultat
0 2 -1 red
`new String("red")` crée volontairement un objet distinct contenant le même texte. Les première et dernière occurrences sont aux indices `0` et `2` ; `"green"` donne `-1`. La condition protège l’appel à `get`, qui permet d’afficher `red`.
Leçons associées
- Java · Leçon 54 · Débutant · Version : 2