CKTIS / Java
Set.contains — vérifier si un ensemble contient un élément
Vérifiez si un ensemble contient un élément égal à l’objet fourni et découvrez pourquoi une nouvelle instance de même identifiant peut être trouvée.
Version : Java SE 21
Syntaxe
boolean contains(Object o)
boolean present = set.contains(candidate);Set.contains est une méthode d’instance de l’interface java.util.Set<E>. L’appel set.contains(candidate) renvoie true s’il existe un élément stocké e pour lequel Objects.equals(candidate, e) vaut true, et false sinon. La méthode n’ajoute ni ne renvoie d’élément. Elle teste l’égalité, et non l’identité des références (==).
Le paramètre est de type Object, pas E : on peut donc interroger un Set<Member> avec un objet d’un autre type. Selon l’implémentation, une recherche avec un type incompatible peut renvoyer false ou lever ClassCastException. Si l’ensemble interdit null, une recherche avec null peut renvoyer false ou lever NullPointerException. HashSet accepte null : contains(null) ne renvoie true que si null est présent.
Pour la recherche, HashSet utilise hashCode et equals. Deux objets égaux doivent avoir le même code de hachage, mais un code identique ne suffit pas à établir leur égalité. Ne modifiez pas les données dont dépend equals tant que l’objet est dans l’ensemble : le comportement de l’ensemble après une telle modification n’est pas spécifié.
Les records de l’exemple utilisent les implémentations par défaut de equals et hashCode. Deux objets Member ayant le même id sont égaux, même s’ils ont été créés séparément. Un Guest de même id n’est pas égal à un Member, car il appartient à une autre classe de record.
Exemples
import java.util.HashSet;
import java.util.Set;
public class Main {
record Member(int id) {}
record Guest(int id) {}
public static void main(String[] args) {
Set<Member> members = new HashSet<>();
members.add(new Member(100));
System.out.println(members.contains(new Member(100)));
System.out.println(members.contains(new Member(101)));
System.out.println(members.contains(new Guest(100)));
}
}Résultat
true false false
La première ligne vaut `true` : le nouveau `Member(100)` est égal à l’élément stocké. `Member(101)` a un autre identifiant et `Guest(100)` appartient à une autre classe : les deux lignes suivantes valent donc `false`.
Leçons associées
- Java · Leçon 5 · Avancé · Version : 2
- Java · Leçon 42 · Débutant · Version : 2