CKTIS / Java
EnumSet.of — vytvoření množiny konstant výčtu
Vytvořte zpočátku neprázdnou a měnitelnou množinu konstant jednoho výčtového typu. Rozlišujte vlastnosti kolektoru a bitovou masku spliterátoru.
Verze: Java SE 21
Syntaxe
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 je statická tovární metoda třídy java.util.EnumSet. Vrací nový, měnitelný EnumSet<E>, který je zpočátku neprázdný. Všechny konstanty musejí patřit do stejného výčtového typu E; v typově bezpečném kódu vede kombinace různých výčtových typů k chybě při překladu. Opakovaná konstanta se v množině objeví jen jednou. Iterace probíhá v pořadí deklarace, nikoli v pořadí argumentů.
Existuje pět přetížení s pevným počtem argumentů, od jednoho do pěti. of(E first, E... rest) vyžaduje první konstantu a zbytek přijímá jako další argumenty nebo jako pole. Varianta of() bez argumentů neexistuje; pro prázdnou množinu použijte EnumSet.noneOf(Access.class). Hodnota null místo konstanty nebo pole rest s hodnotou null vyvolá NullPointerException.
Tříargumentové EnumSet.of může seskupit tři hodnoty Collector.Characteristics: CONCURRENT umožňuje více vláknům volat akumulátor nad stejným kontejnerem, UNORDERED nezaručuje zachování pořadí, v němž se vstupní prvky zpracovávají, a IDENTITY_FINISH říká, že dokončovací funkce je identita. Samotná množina kolektor nenakonfiguruje. Při implementaci Collector.characteristics() vracejte neměnitelnou množinu, ne přímo měnitelný EnumSet. Naproti tomu Spliterator.characteristics() vrací bitovou masku typu int, která popisuje spliterátor a jeho prvky, ne množinu výčtových hodnot kolektoru.
Příklady
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);
}
}Výsledek
[READ] [READ, WRITE] [CONCURRENT, UNORDERED, IDENTITY_FINISH]
První dvě volání používají přetížení s jedním a dvěma argumenty. Druhé předává `WRITE` před `READ`, ale výpis odpovídá pořadí deklarace. Poslední volání vytváří pouze množinu vlastností, nikoli kolektor ani spliterátor.
Související lekce
- Java · Lekce 19 · Pokročilá · Verze: 2
- Java · Lekce 24 · Pokročilá · Verze: 2