CKTIS / Java
HashSet.add(E): een element aan een verzameling toevoegen
`HashSet.add(E)` geeft `true` terug als een nieuw element wordt toegevoegd en `false` als de verzameling al een gelijk element bevat.
Versie: Java SE 21
Syntax
public boolean add(E e)In Java SE 21 is HashSet.add(E) een instantiemethode van java.util.HashSet<E>. De methode neemt één element e aan van het elementtype E van de verzameling, bijvoorbeeld String in HashSet<String>.
Als er geen element e2 is waarvoor Objects.equals(e, e2) true oplevert, voegt de methode e toe, neemt het aantal elementen met één toe en geeft de methode true terug. Anders geeft ze false terug en blijft de verzameling ongewijzigd: het bestaande element wordt niet vervangen. HashSet staat null toe. De eerste toevoeging van null levert dus true op; volgende pogingen leveren false op zolang null in de verzameling zit.
Zorg er in je eigen klassen voor dat equals en hashCode consistent zijn: gelijke objecten moeten dezelfde hashcode hebben, maar dezelfde hashcode betekent niet dat objecten gelijk zijn. Verander de gegevens die deze methoden gebruiken niet zolang het object in de verzameling zit. HashSet garandeert geen iteratievolgorde, ook niet de volgorde van toevoegen.
Gebruik if (tags.add(tag)) om code alleen uit te voeren als het element is toegevoegd, zonder eerst contains aan te roepen. Niet elke Set werkt zo: een verzameling die met Set.of(...) is gemaakt, kan niet worden gewijzigd. Een aanroep van add daarop gooit een UnsupportedOperationException.
Voorbeelden
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());
}
}Resultaat
true false true false 2
`new String("java")` maakt bewust een ander object met dezelfde tekst. De tweede aanroep geeft `false` terug omdat de tekenreeksen gelijk zijn, niet omdat ze hetzelfde object zijn. Uiteindelijk bevat de verzameling twee elementen: `"java"` en `null`.
Gerelateerde lessen
- Java · Les 55 · Basis · Versie: 2