Base de connaissancesCentre d’examen
FRFrançais
Choisir la langue13

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

Sources