CKTIS / Java
java.util.Set — eine Sammlung ohne Duplikate
Set<E> beschreibt eine Sammlung eindeutiger Elemente. Erfahre, wie du Elemente hinzufügst, ihre Anwesenheit prüfst, sie entfernst und zählst und wie sich die Schnittstelle Set von der Implementierung HashSet unterscheidet.
Version: Java SE 21; repository runtime, production runtime not attested
Syntax
Set<E> values = new HashSet<>();
boolean added = values.add(element);
int count = values.size();
boolean present = values.contains(element);
boolean removed = values.remove(element);java.util.Set<E> ist eine Sammlungsschnittstelle ohne Duplikate; E bezeichnet den Elementtyp. Der Set-Vertrag definiert Duplikate über equals, nicht über die Objektidentität. Set garantiert weder eine Iterationsreihenfolge noch den Zugriff über einen Index.
Set.add(E) gibt true zurück, wenn ein neues Element hinzugefügt wurde; bei einem Duplikat gibt die Methode false zurück und lässt das Set unverändert. Set.size() gibt die Anzahl der Elemente als int zurück (höchstens Integer.MAX_VALUE). Set.contains(Object) prüft, ob ein Element enthalten ist. Wenn Set.remove(Object) ohne Ausnahme abgeschlossen wird, gibt die Methode true zurück, wenn sie das Element entfernt hat, und false, wenn es nicht enthalten war.
HashSet ist eine veränderbare Implementierung: Sie erlaubt null, garantiert keine Iterationsreihenfolge und ist nicht synchronisiert. Ob null unterstützt wird, hängt von der Implementierung ab. Ändernde Operationen sind in der Schnittstelle optional und können auch dann UnsupportedOperationException auslösen, wenn das Element nicht enthalten ist. Beispielsweise löst Set.of("java").remove("missing") diese Ausnahme aus, statt false zurückzugeben.
Ändere keine Felder, die equals beeinflussen, solange ein Objekt zu einem Set gehört: Das Verhalten des Sets ist dann nicht spezifiziert. Das Beispiel verwendet String und gibt nur die Operationsergebnisse aus, sodass es nicht von der Iterationsreihenfolge abhängt.
Beispiele
import java.util.HashSet;
import java.util.Set;
public class SetDemo {
public static void main(String[] args) {
Set<String> tags = new HashSet<>();
System.out.println(tags.add("java"));
System.out.println(tags.add("java"));
System.out.println(tags.size());
System.out.println(tags.contains("java"));
System.out.println(tags.remove("java"));
System.out.println(tags.remove("java"));
System.out.println(tags.size());
}
}Ergebnis
true false 1 true true false 0
Der angezeigte Code und das angegebene Ergebnis wurden in einer isolierten Umgebung mit der im Prüfnachweis für genau diese Version dokumentierten Methode verifiziert.