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

CKTIS / Java

EnumMap: criar o mapa, escrever, ler e contar entradas

Cria um EnumMap vazio com Day.class, guarda e lê valores e verifica por que razão substituir o valor de uma chave existente não altera o número de entradas.

Versão: Java SE 21

Sintaxe

import java.util.EnumMap;

EnumMap<Day, String> plan = new EnumMap<>(Day.class);
String previous = plan.put(Day.MON, "Study");
String current = plan.get(Day.MON);
int count = plan.size();

java.util.EnumMap<K, V> usa chaves de um único tipo enumerado. O construtor EnumMap(Class), declarado como EnumMap(Class<K> keyType), recebe um objeto de classe como Day.class, não uma constante como Day.MON. Cria um mapa vazio, sem adicionar entradas para as constantes. Passar null como keyType lança uma NullPointerException.

put(K key, V value) adiciona uma entrada para uma chave nova ou substitui o valor de uma chave existente. Devolve o valor anterior, não o valor acabado de guardar. Um resultado null significa que não existia uma entrada anterior ou que o seu valor era null. Os valores null são permitidos, mas passar uma chave null a put lança uma NullPointerException.

get(Object key) lê um valor sem alterar o mapa. Devolve null tanto para uma chave ausente como para uma chave explicitamente associada a null. containsKey(key) distingue os dois casos: devolve true se a entrada existir, mesmo que o seu valor seja null.

size() devolve o número atual de entradas como um int, não o número de constantes da enumeração. Uma chave nova aumenta a contagem em um, mesmo que o seu valor seja null. Substituir o valor de uma chave existente não altera a contagem.

Exemplos

import java.util.EnumMap;

public class Main {
    enum Day { MON, TUE, WED }

    public static void main(String[] args) {
        EnumMap<Day, String> plan = new EnumMap<>(Day.class);
        System.out.println("initial size: " + plan.size());

        plan.put(Day.MON, "Study");
        System.out.println("after insert: " + plan.size());
        System.out.println("previous MON: " + plan.put(Day.MON, "Review"));
        System.out.println("current MON: " + plan.get(Day.MON));
        System.out.println("after update: " + plan.size());

        plan.put(Day.TUE, null);
        System.out.println("TUE: " + plan.get(Day.TUE) + ", present: " + plan.containsKey(Day.TUE));
        System.out.println("WED: " + plan.get(Day.WED) + ", present: " + plan.containsKey(Day.WED));
        System.out.println("final size: " + plan.size());
    }
}

Resultado

initial size: 0
after insert: 1
previous MON: Study
current MON: Review
after update: 1
TUE: null, present: true
WED: null, present: false
final size: 2

Depois de inserir `MON`, o mapa tem uma entrada. A atualização devolve `Study` e a leitura devolve `Review`; a contagem mantém-se em `1`. `TUE` está associado a `null` e conta como segunda entrada, ao passo que `WED` está ausente.

Lições relacionadas

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

Fontes