WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

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.

Quellen