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

CKTIS / Java

EnumSet — um conjunto de constantes de um tipo enum

EnumSet armazena constantes de um único tipo enum sem duplicados. Aprende a criar conjuntos com of e allOf e a utilizar as operações add, remove e contains.

Versão: Java SE 21; repository runtime, production runtime not attested

Sintaxe

EnumSet<E> selected = EnumSet.of(E.VALUE);
EnumSet<E> all = EnumSet.allOf(E.class);
boolean added = selected.add(E.OTHER);
boolean removed = selected.remove(E.VALUE);
boolean present = selected.contains(E.OTHER);

java.util.EnumSet<E> é um conjunto modificável de constantes de um único tipo enum, representado internamente por vetores de bits. A iteração segue a ordem de declaração das constantes, não a ordem pela qual foram adicionadas.

EnumSet.of(...) cria um conjunto de constantes selecionadas e exige pelo menos uma. EnumSet.allOf(E.class) cria um conjunto com todas as constantes do tipo. Para criar um conjunto vazio, utiliza EnumSet.noneOf(E.class).

EnumSet.add adiciona um elemento que não está presente e EnumSet.remove remove um elemento presente; ambos os métodos devolvem true apenas quando alteram o conjunto. Adicionar novamente um elemento não cria um duplicado. EnumSet.contains devolve true se o elemento pertencer ao conjunto; não altera o conteúdo.

Adicionar null provoca uma NullPointerException; contains(null) e remove(null) devolvem false. O conjunto não é sincronizado: o acesso partilhado que envolva modificações requer sincronização externa. O exemplo destina-se ao Java SE 21; não certifica a versão do ambiente de execução em produção.

Exemplos

import java.util.EnumSet;

public class Main {
    enum Permission { READ, WRITE, EXECUTE }

    public static void main(String[] args) {
        EnumSet<Permission> selected =
                EnumSet.of(Permission.WRITE, Permission.READ);
        System.out.println(selected);
        System.out.println(selected.add(Permission.EXECUTE));
        System.out.println(selected.add(Permission.READ));
        System.out.println(selected.remove(Permission.WRITE));
        System.out.println(selected.contains(Permission.WRITE));
        System.out.println(selected);
        System.out.println(EnumSet.allOf(Permission.class));
    }
}

Resultado

[READ, WRITE]
true
false
true
false
[READ, EXECUTE]
[READ, WRITE, EXECUTE]

O código apresentado e o resultado declarado foram verificados num ambiente isolado pelo método registado na prova de verificação desta versão exata.

Fontes