CKTIS / Java
EnumSet.of — créer un ensemble de constantes d’énumération
Créez un ensemble modifiable, initialement non vide, de constantes d’un même type énuméré. Distinguez les caractéristiques d’un collecteur du masque de bits d’un spliterator.
Version : 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 est une méthode de fabrique statique de java.util.EnumSet. Elle renvoie un nouveau EnumSet<E> modifiable et initialement non vide. Toutes les constantes doivent appartenir au même type énuméré E ; dans du code qui respecte le typage, le mélange de types énumérés échoue à la compilation. Une constante répétée ne figure qu’une fois dans l’ensemble. L’itération suit l’ordre de déclaration, pas celui des arguments.
Cinq surcharges acceptent un nombre fixe d’arguments, de un à cinq. of(E first, E... rest) exige une première constante et accepte les suivantes sous forme d’arguments supplémentaires ou de tableau. Il n’existe pas de of() sans argument ; utilisez EnumSet.noneOf(Access.class) pour partir d’un ensemble vide. Une constante null ou un tableau rest égal à null déclenche une NullPointerException.
Avec trois arguments, EnumSet.of peut réunir trois valeurs de Collector.Characteristics : CONCURRENT permet à plusieurs threads d’appeler l’accumulateur sur le même conteneur, UNORDERED ne garantit pas le maintien de l’ordre de rencontre des éléments d’entrée et IDENTITY_FINISH indique que la fonction de finition est l’identité. Cet ensemble ne configure pas à lui seul un collecteur. Si vous implémentez Collector.characteristics(), renvoyez un ensemble non modifiable, pas directement l’EnumSet modifiable. À l’inverse, Spliterator.characteristics() renvoie un masque de bits de type int décrivant le spliterator et ses éléments, et non un ensemble de valeurs de l’énumération du collecteur.
Exemples
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);
}
}Résultat
[READ] [READ, WRITE] [CONCURRENT, UNORDERED, IDENTITY_FINISH]
Les deux premiers appels utilisent les surcharges à un et deux arguments. Le deuxième passe `WRITE` avant `READ`, mais l’affichage suit l’ordre de déclaration. Le dernier appel crée seulement un ensemble de caractéristiques, ni collecteur ni spliterator.
Leçons associées
- Java · Leçon 19 · Avancé · Version : 2
- Java · Leçon 24 · Avancé · Version : 2