Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / Java

EnumSet: creare insiemi e gestirne gli elementi

Crea insiemi modificabili di costanti di uno stesso tipo enumerato e distingui un controllo di appartenenza da una modifica effettiva.

Versione: Java SE 21

Sintassi

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> è un insieme modificabile di costanti di un solo tipo enumerato. Non contiene duplicati e l’iterazione segue l’ordine di dichiarazione delle costanti, non quello di inserimento.

Il metodo factory statico EnumSet.of(...) crea un insieme con le costanti selezionate. Ha overload con un numero fisso di argomenti, da uno a cinque, e un overload varargs, of(E first, E... rest), che richiede una prima costante. EnumSet.allOf(Day.class) riceve un oggetto classe anziché una costante e crea un insieme con tutte le costanti di Day. Per partire con un insieme vuoto, usa EnumSet.noneOf(Day.class), non EnumSet.of(). A differenza del risultato di Set.of(...), gli insiemi creati da questi metodi di EnumSet sono modificabili.

add(E e) restituisce true solo se inserisce una costante assente, mentre remove(Object o) lo restituisce solo se rimuove un elemento presente. Aggiungere un duplicato o rimuovere un elemento assente restituisce false. contains(Object o) restituisce true quando l’elemento è presente e non modifica l’insieme.

Un EnumSet non può memorizzare null. add(null) genera una NullPointerException, ma contains(null) e remove(null) restituiscono entrambi false. Anche passare null al posto di una costante a EnumSet.of(...) genera una NullPointerException.

Esempi

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));
    }
}

Risultato

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’esempio crea un insieme con cinque giorni lavorativi, un insieme separato con due permessi e un insieme con tutti e sette i giorni. All’inizio `SAT` non appartiene a `days`, quindi solo il primo inserimento e la prima rimozione modificano l’insieme.

Lezioni correlate

  • Java · Lezione 10 · Intermedio · Versione: 2

Fonti