Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

CKTIS / Java

EnumSet: criar conjuntos e operar sobre os seus elementos

Cria conjuntos modificáveis de constantes de um único tipo enumerado e distingue um teste de pertença de uma alteração efetiva ao conjunto.

Versão: Java SE 21

Sintaxe

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> é um conjunto modificável de constantes de um único tipo enumerado. Não guarda duplicados e a iteração segue a ordem de declaração das constantes, não a ordem de inserção.

O método de fábrica estático EnumSet.of(...) cria um conjunto com as constantes escolhidas. Tem sobrecargas com um número fixo de argumentos, de um a cinco, e uma sobrecarga com argumentos variáveis, of(E first, E... rest), que exige uma primeira constante. EnumSet.allOf(Day.class) recebe um objeto de classe em vez de uma constante e cria um conjunto com todas as constantes de Day. Para começar com um conjunto vazio, usa EnumSet.noneOf(Day.class), não EnumSet.of(). Ao contrário do resultado de Set.of(...), os conjuntos criados por estes métodos de EnumSet são modificáveis.

add(E e) devolve true apenas se inserir uma constante que ainda não está no conjunto, e remove(Object o) devolve true apenas se remover um elemento presente. Adicionar um duplicado ou tentar remover um elemento ausente devolve false. contains(Object o) devolve true se o elemento estiver presente e não altera o conjunto.

Um EnumSet não pode guardar null. add(null) lança NullPointerException, mas contains(null) e remove(null) devolvem false. Passar null em vez de uma constante a EnumSet.of(...) também lança NullPointerException.

Exemplos

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

Resultado

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

O exemplo cria um conjunto com cinco dias úteis, um conjunto separado com duas permissões e um conjunto com os sete dias. Inicialmente, `SAT` não pertence a `days`, pelo que só a primeira adição e a primeira remoção alteram esse conjunto.

Lições relacionadas

  • Java · Lição 10 · Intermédio · Versão: 2

Fontes