CKTIS / Java
List.contains(Object) — vérifier si une liste contient un élément
Vérifiez si la liste contient un élément égal à la valeur recherchée avant d’ajouter un nom de tâche ou de marquer la tâche comme terminée.
Version : Java SE 21
Syntaxe
boolean contains(Object o)
boolean present = list.contains(value);List.contains(Object) est une méthode de java.util.List. L’appel list.contains(o) renvoie true s’il existe un élément e tel que Objects.equals(o, e) vaut true, et false en l’absence de correspondance. La méthode ne renvoie pas d’indice et ne modifie pas la liste.
Les deux références n’ont pas besoin de désigner le même objet. String.equals compare toute la séquence de caractères en distinguant majuscules et minuscules : "Review" correspond à un autre objet String de même contenu, mais ni à "review" ni à la sous-chaîne "Rev".
Le paramètre est de type Object, et non E, même pour une List<String>. Si le type de l’argument est incompatible, l’implémentation peut renvoyer false ou lever une ClassCastException. Si la liste accepte null, contains(null) ne renvoie true que si la liste contient null. Sinon, l’appel peut renvoyer false ou lever une NullPointerException.
Dans du code exécuté par un seul thread, utilisez !tasks.contains(name) avant d’ajouter un nom à une liste modifiable pour éviter un doublon. Utilisez tasks.contains(name) pour vérifier que le nom existe avant qu’une opération distincte marque la tâche comme terminée.
Exemples
import java.util.ArrayList;
import java.util.List;
public class Main {
public static void main(String[] args) {
List<String> tasks = new ArrayList<>();
tasks.add("Review");
String candidate = new String("Review");
System.out.println(tasks.contains(candidate));
System.out.println(tasks.contains("review"));
if (!tasks.contains(candidate)) {
tasks.add(candidate);
}
System.out.println(tasks.size());
}
}Résultat
true false 1
`candidate` est un objet distinct dont le texte est identique à celui de l’élément stocké : le premier résultat est `true`. Une minuscule à la place de la première majuscule donne `false`. La condition évite le doublon et la taille reste `1`.
Leçons associées
- Java · Leçon 22 · Intermédiaire · Version : 2