CKTIS / Java
HashSet.add(E) — ajouter un élément à un ensemble
`HashSet.add(E)` renvoie `true` quand un nouvel élément est inséré et `false` si l’ensemble contient déjà un élément égal.
Version : Java SE 21
Syntaxe
public boolean add(E e)Dans Java SE 21, HashSet.add(E) est une méthode d’instance de java.util.HashSet<E>. Elle prend un élément e du type E choisi pour l’ensemble, par exemple String dans HashSet<String>.
Si l’ensemble ne contient aucun élément e2 tel que Objects.equals(e, e2) renvoie true, la méthode insère e, augmente la taille de l’ensemble d’une unité et renvoie true. Sinon, elle renvoie false sans modifier l’ensemble : elle ne remplace pas l’élément existant. HashSet accepte null. Le premier ajout de null renvoie donc true ; les suivants renvoient false tant que null reste dans l’ensemble.
Pour vos propres classes, veillez à la cohérence entre equals et hashCode : deux objets égaux doivent avoir le même code de hachage, mais un même code de hachage n’implique pas que les objets soient égaux. Ne modifiez pas les données utilisées par ces méthodes tant que l’objet appartient à l’ensemble. HashSet ne garantit aucun ordre de parcours, pas même l’ordre d’insertion.
Utilisez if (tags.add(tag)) pour exécuter du code uniquement si l’élément a été ajouté, sans appeler contains au préalable. Tous les Set ne se comportent pas ainsi : un ensemble créé par Set.of(...) n’est pas modifiable, et un appel à add sur cet ensemble lève une UnsupportedOperationException.
Exemples
import java.util.HashSet;
public class Main {
public static void main(String[] args) {
HashSet<String> tags = new HashSet<>();
System.out.println(tags.add("java"));
System.out.println(tags.add(new String("java")));
System.out.println(tags.add(null));
System.out.println(tags.add(null));
System.out.println(tags.size());
}
}Résultat
true false true false 2
`new String("java")` crée volontairement un autre objet contenant le même texte. Le deuxième appel renvoie `false` parce que les chaînes sont égales, et non parce qu’il s’agit du même objet. À la fin, l’ensemble contient deux éléments : `"java"` et `null`.
Leçons associées
- Java · Leçon 55 · Débutant · Version : 2