CKTIS / Java
EnumSet.of — zbiór wybranych stałych enum
Twórz początkowo niepusty, modyfikowalny zbiór stałych jednego typu wyliczeniowego. Odróżniaj cechy kolektora od maski bitowej spliteratora.
Wersja: Java SE 21
Składnia
public static <E extends Enum<E>> EnumSet<E> of(E e)
public static <E extends Enum<E>> EnumSet<E> of(E e1, E e2)
public static <E extends Enum<E>> EnumSet<E> of(E e1, E e2, E e3)
public static <E extends Enum<E>> EnumSet<E> of(E e1, E e2, E e3, E e4)
public static <E extends Enum<E>> EnumSet<E> of(E e1, E e2, E e3, E e4, E e5)
@SafeVarargs
public static <E extends Enum<E>> EnumSet<E> of(E first, E... rest)EnumSet.of to statyczna metoda fabrykująca klasy java.util.EnumSet. Zwraca nowy, modyfikowalny EnumSet<E>, który początkowo jest niepusty. Wszystkie stałe muszą należeć do tego samego typu wyliczeniowego E; w kodzie z kontrolą typów próba połączenia różnych typów enum nie przejdzie kompilacji. Powtórzenia dają jeden element, a iteracja przebiega w kolejności deklaracji stałych, nie w kolejności argumentów.
Istnieje pięć przeciążeń o stałej liczbie argumentów, od jednego do pięciu. Przeciążenie of(E first, E... rest) wymaga pierwszej stałej, a resztę przyjmuje jako kolejne argumenty lub tablicę. Nie ma of() bez argumentów: pusty zbiór utworzysz przez EnumSet.noneOf(Access.class). Stała o wartości null lub tablica rest o wartości null powoduje NullPointerException.
Trzyargumentowe EnumSet.of może zebrać trzy wartości Collector.Characteristics: CONCURRENT pozwala wielu wątkom wywoływać akumulator na tym samym kontenerze, UNORDERED oznacza brak gwarancji zachowania kolejności napotykania elementów wejściowych, a IDENTITY_FINISH oznacza, że funkcja kończąca jest funkcją tożsamościową. Sam zbiór nie konfiguruje kolektora. Jeśli implementujesz Collector.characteristics(), zwróć niemodyfikowalny zbiór, a nie bezpośrednio modyfikowalny EnumSet. Natomiast Spliterator.characteristics() zwraca maskę bitową typu int opisującą spliterator i jego elementy, nie zbiór wartości enum kolektora.
Przykłady
import java.util.EnumSet;
import java.util.stream.Collector.Characteristics;
public class Main {
enum Access { READ, WRITE }
public static void main(String[] args) {
EnumSet<Access> readOnly = EnumSet.of(Access.READ);
EnumSet<Access> readWrite = EnumSet.of(Access.WRITE, Access.READ);
EnumSet<Characteristics> characteristics = EnumSet.of(
Characteristics.UNORDERED,
Characteristics.CONCURRENT,
Characteristics.IDENTITY_FINISH);
System.out.println(readOnly);
System.out.println(readWrite);
System.out.println(characteristics);
}
}Wynik
[READ] [READ, WRITE] [CONCURRENT, UNORDERED, IDENTITY_FINISH]
Pierwsze dwa wywołania używają przeciążeń jedno- i dwuargumentowego. Choć w drugim `WRITE` podano przed `READ`, wydruk pokazuje kolejność deklaracji. Ostatnie wywołanie tworzy jedynie zbiór cech, bez kolektora i spliteratora.
Powiązane lekcje
- Java · Lekcja 19 · Zaawansowany · Wersja: 2
- Java · Lekcja 24 · Zaawansowany · Wersja: 2