Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / Java

EnumSet — zbiór stałych jednego typu enum

EnumSet przechowuje bez duplikatów stałe jednego typu enum. Poznaj tworzenie zbiorów przez of i allOf oraz operacje add, remove i contains.

Wersja: Java SE 21; repository runtime, production runtime not attested

Składnia

EnumSet<E> selected = EnumSet.of(E.VALUE);
EnumSet<E> all = EnumSet.allOf(E.class);
boolean added = selected.add(E.OTHER);
boolean removed = selected.remove(E.VALUE);
boolean present = selected.contains(E.OTHER);

java.util.EnumSet<E> to modyfikowalny zbiór stałych jednego typu enum, reprezentowany wewnętrznie przez wektory bitowe. Iteracja zachowuje kolejność deklaracji stałych, nie kolejność dodawania.

EnumSet.of(...) tworzy zbiór wybranych stałych; wymaga co najmniej jednej. EnumSet.allOf(E.class) tworzy zbiór wszystkich stałych typu. Pusty zbiór utworzysz przez EnumSet.noneOf(E.class).

EnumSet.add dodaje nieobecny element, a EnumSet.remove usuwa obecny; obie metody zwracają true tylko wtedy, gdy zmieniły zbiór. Ponowne dodanie elementu nie tworzy duplikatu. EnumSet.contains zwraca true, jeśli element należy do zbioru; nie zmienia zawartości.

Dodanie null powoduje NullPointerException; contains(null) i remove(null) zwracają false. Zbiór nie jest synchronizowany: współdzielony dostęp z modyfikacją wymaga zewnętrznej synchronizacji. Przykład dotyczy Java SE 21; nie potwierdza wersji środowiska produkcyjnego.

Przykłady

import java.util.EnumSet;

public class Main {
    enum Permission { READ, WRITE, EXECUTE }

    public static void main(String[] args) {
        EnumSet<Permission> selected =
                EnumSet.of(Permission.WRITE, Permission.READ);
        System.out.println(selected);
        System.out.println(selected.add(Permission.EXECUTE));
        System.out.println(selected.add(Permission.READ));
        System.out.println(selected.remove(Permission.WRITE));
        System.out.println(selected.contains(Permission.WRITE));
        System.out.println(selected);
        System.out.println(EnumSet.allOf(Permission.class));
    }
}

Wynik

[READ, WRITE]
true
false
true
false
[READ, EXECUTE]
[READ, WRITE, EXECUTE]

Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.

Źródła