CKTIS / Java
EnumSet : créer des ensembles et manipuler leurs éléments
Créez des ensembles modifiables de constantes d’un même type énuméré et distinguez un test d’appartenance d’une modification effective.
Version : Java SE 21
Syntaxe
import java.util.EnumSet;
// E extends Enum<E>; static factories:
EnumSet.of(e1) // fixed-arity overloads for 1–5 arguments
EnumSet.of(first, rest) // rest is an E[]; varargs declaration: of(E first, E... rest)
EnumSet.allOf(MyEnum.class) // all constants of MyEnum
EnumSet.noneOf(MyEnum.class) // no constants of MyEnum
// Instance method signatures:
boolean add(E e)
boolean contains(Object o)
boolean remove(Object o)java.util.EnumSet<E> est un ensemble modifiable de constantes d’un seul type énuméré. Il ne contient pas de doublons et son parcours suit l’ordre de déclaration des constantes, pas leur ordre d’insertion.
La méthode de fabrique statique EnumSet.of(...) crée un ensemble à partir de constantes choisies. Elle a des surcharges à nombre fixe d’arguments, de un à cinq, et une surcharge à nombre variable d’arguments, of(E first, E... rest), qui exige une première constante. EnumSet.allOf(Day.class) reçoit un objet de classe plutôt qu’une constante et crée un ensemble contenant toutes les constantes de Day. Pour partir d’un ensemble vide, utilisez EnumSet.noneOf(Day.class), pas EnumSet.of(). Contrairement au résultat de Set.of(...), les ensembles créés par ces méthodes d’EnumSet sont modifiables.
add(E e) renvoie true uniquement si une constante absente est ajoutée ; remove(Object o) renvoie true uniquement si un élément présent est retiré. Ajouter un doublon ou retirer un élément absent renvoie false. contains(Object o) renvoie true si l’élément est présent et ne modifie pas l’ensemble.
Un EnumSet ne peut pas stocker null. add(null) lève une NullPointerException, tandis que contains(null) et remove(null) renvoient false. Passer null à la place d’une constante à EnumSet.of(...) lève aussi une NullPointerException.
Exemples
import java.util.EnumSet;
public class EnumSetDemo {
enum Day { MON, TUE, WED, THU, FRI, SAT, SUN }
enum Permission { READ, WRITE, DELETE }
public static void main(String[] args) {
EnumSet<Day> days = EnumSet.of(Day.MON, Day.TUE, Day.WED, Day.THU, Day.FRI);
EnumSet<Permission> permissions = EnumSet.of(Permission.READ, Permission.WRITE);
EnumSet<Day> allDays = EnumSet.allOf(Day.class);
System.out.println("initial days: " + days);
System.out.println("all days: " + allDays.size());
System.out.println("can delete: " + permissions.contains(Permission.DELETE));
System.out.println("add SAT: " + days.add(Day.SAT));
System.out.println("add SAT again: " + days.add(Day.SAT));
System.out.println("remove SAT: " + days.remove(Day.SAT));
System.out.println("remove SAT again: " + days.remove(Day.SAT));
System.out.println("contains SAT: " + days.contains(Day.SAT));
}
}Résultat
initial days: [MON, TUE, WED, THU, FRI] all days: 7 can delete: false add SAT: true add SAT again: false remove SAT: true remove SAT again: false contains SAT: false
L’exemple crée un ensemble de cinq jours ouvrés, un ensemble distinct de deux permissions et un ensemble des sept jours. `SAT` est initialement absent de `days` : seuls le premier ajout et le premier retrait modifient cet ensemble.
Leçons associées
- Java · Leçon 10 · Intermédiaire · Version : 2