CKTIS / Java
HashSet.add(E) — ein Element zu einer Menge hinzufügen
`HashSet.add(E)` gibt beim Einfügen eines neuen Elements `true` zurück. Ist bereits ein gleiches Element vorhanden, gibt die Methode `false` zurück.
Version: Java SE 21
Syntax
public boolean add(E e)In Java SE 21 ist HashSet.add(E) eine Instanzmethode von java.util.HashSet<E>. Sie nimmt ein Element e vom Elementtyp E der Menge entgegen, etwa String bei HashSet<String>.
Gibt es kein Element e2, für das Objects.equals(e, e2) den Wert true liefert, fügt die Methode e ein, erhöht die Anzahl der Elemente um eins und gibt true zurück. Andernfalls gibt sie false zurück und lässt die Menge unverändert: Das vorhandene Element wird nicht ersetzt. HashSet erlaubt null. Das erste Einfügen von null liefert daher true, ein weiterer Versuch liefert false, solange null enthalten ist.
Stimme bei eigenen Klassen equals und hashCode aufeinander ab: Gleiche Objekte müssen denselben Hashcode haben, aber gleiche Hashcodes bedeuten nicht, dass die Objekte gleich sind. Ändere die von diesen Methoden verwendeten Daten nicht, solange das Objekt in der Menge ist. HashSet garantiert keine Iterationsreihenfolge, auch nicht die Einfügereihenfolge.
Mit if (tags.add(tag)) führst du Code nur nach erfolgreichem Einfügen aus, ohne vorher contains aufzurufen. Nicht jedes Set verhält sich so: Eine mit Set.of(...) erstellte Menge ist unveränderbar; ein Aufruf von add löst dort eine UnsupportedOperationException aus.
Beispiele
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());
}
}Ergebnis
true false true false 2
`new String("java")` erzeugt absichtlich ein anderes Objekt mit demselben Text. Der zweite Aufruf liefert `false`, weil die Zeichenketten gleich sind, nicht weil es sich um dasselbe Objekt handelt. Am Ende enthält die Menge zwei Elemente: `"java"` und `null`.
Zugehörige Lektionen
- Java · Lektion 55 · Grundlagen · Version: 2