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

CKTIS / Java

java.util.Map — associar chaves a valores

Map<K,V> associa cada chave a, no máximo, um valor. Aprende a consultar e atualizar dados, calcular valores e usar vistas do mapa, prestando especial atenção ao tratamento de null e às garantias da implementação.

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

Sintaxe

Map<K, V> map = new HashMap<>();

java.util.Map<K,V> é uma interface que associa chaves a valores; os valores podem repetir-se. HashMap não garante qualquer ordem, enquanto TreeMap ordena as chaves. O suporte para null depende da implementação. Não alteres uma chave armazenada de forma a afetar a sua comparação.

Map.put(k, v) adiciona ou substitui um valor e devolve o anterior; Map.remove(k) elimina uma entrada e devolve o seu valor antigo. Ambos também devolvem null se a entrada estiver ausente. Map.get(k) devolve o valor ou null; Map.containsKey(k) distingue uma entrada ausente de uma entrada associada a null. Map.getOrDefault(k, d) devolve d apenas se a entrada estiver ausente, não quando o valor associado é null. Map.size() conta as entradas; Map.containsValue(v) verifica se um valor existe.

Map.compute(k, f) passa à função a chave e o valor atual, ou null; um resultado null elimina a entrada ou deixa-a ausente. Map.computeIfAbsent(k, f) chama a função quando a entrada está ausente ou o seu valor é null; só armazena um resultado não nulo. Map.merge(k, v, f) exige v != null: se a entrada estiver ausente ou o seu valor for null, armazena v; caso contrário, combina o valor antigo com v. Um resultado null elimina a entrada.

Map.keySet() expõe um conjunto de chaves, Map.values() uma coleção de valores e Map.entrySet() um conjunto de pares Map.Entry<K,V>. São vistas associadas ao mapa, não cópias; remover através de uma vista elimina a entrada quando a operação é suportada. Map.forEach(action) percorre cada par.

As operações que modificam o mapa podem lançar UnsupportedOperationException. As funções de cálculo não devem modificar o mesmo mapa. Os métodos predefinidos de Map não garantem atomicidade nem sincronização. O exemplo usa TreeMap para obter uma ordem de saída determinística.

Exemplos

import java.util.Map;
import java.util.TreeMap;

public class Main {
    public static void main(String[] args) {
        Map<String, Integer> counts = new TreeMap<>();
        counts.put("pear", 1);
        counts.merge("pear", 2, Integer::sum);
        counts.computeIfAbsent("apple", key -> 1);
        counts.compute("apple", (key, value) -> value + 1);
        System.out.println(counts.get("pear"));
        System.out.println(counts.getOrDefault("plum", 0));
        System.out.println(counts.containsKey("plum"));
        System.out.println(counts.containsValue(2));
        System.out.println(counts.size());
        System.out.println(counts.keySet());
        System.out.println(counts.values());
        System.out.println(counts.entrySet());
        counts.forEach((key, value) -> System.out.println(key + ":" + value));
        System.out.println(counts.remove("pear"));
        System.out.println(counts.size());
    }
}

Resultado

3
0
false
true
2
[apple, pear]
[2, 3]
[apple=2, pear=3]
apple:2
pear:3
3
1

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