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

CKTIS / Java

Map.entrySet(): percorrer pares chave–valor

Usa `entrySet()` quando precisares da chave e do valor associado em cada passagem do ciclo. O método devolve uma vista do mapa, não uma cópia.

Versão: Java SE 21

Sintaxe

Set<Map.Entry<K, V>> entries = map.entrySet();
for (Map.Entry<K, V> entry : entries) {
    K key = entry.getKey();
    V value = entry.getValue();
}

Map.entrySet designa um método de instância sem argumentos de java.util.Map<K, V>. A notação Map.entrySet() refere-se ao mesmo método com a lista de argumentos vazia; no código, invoca-o numa instância com map.entrySet(). Devolve um Set<Map.Entry<K, V>> com uma entrada por cada associação.

Map.Entry<K, V> é uma interface aninhada em Map. Num ciclo for melhorado, chama entry.getKey() para ler a chave do tipo K e entry.getValue() para ler o valor do tipo V de cada entrada. Não precisas de fazer outra consulta com map.get(key). Usa keySet() se só precisares das chaves ou values() se só precisares dos valores.

O conjunto é uma vista ligada ao mapa, não uma cópia instantânea: as alterações ao mapa refletem-se na vista e, se for possível remover uma entrada através da vista, essa operação também remove a associação do mapa. add e addAll não são suportados. Segundo o contrato geral de Map, alterar o mapa durante a iteração torna o resultado indefinido, salvo com operações suportadas: Iterator.remove() no iterador em uso ou setValue(...) numa entrada devolvida por esse iterador. Não dependas do comportamento dessa entrada depois de a iteração terminar.

entrySet() não ordena as entradas. A ordem da iteração depende da implementação do mapa. No exemplo, new TreeMap<>(counts) cria um mapa separado com as mesmas associações, na ordem natural das chaves. O ciclo percorre a vista dessa cópia.

Exemplos

import java.util.Map;
import java.util.TreeMap;
import java.util.stream.Collectors;
import java.util.stream.Stream;

public class Main {
    public static void main(String[] args) {
        Map<String, Long> counts = Stream.of("pear", "apple", "plum", "apple", "kiwi", "banana", "pear")
                .collect(Collectors.groupingBy(fruit -> fruit, Collectors.counting()));
        Map<String, Long> sorted = new TreeMap<>(counts);

        for (Map.Entry<String, Long> entry : sorted.entrySet()) {
            System.out.println(entry.getKey() + " = " + entry.getValue());
        }
    }
}

Resultado

apple = 2
banana = 1
kiwi = 1
pear = 2
plum = 1

`collect(...)` conta as ocorrências de cada nome de fruta. Só depois de terminar é que o código cria a cópia `TreeMap` e apresenta exatamente cinco linhas, uma por chave, na ordem natural das chaves.

Lições relacionadas

  • Java · Lição 24 · Avançado · Versão: 2
  • Java · Lição 57 · Básico · Versão: 2
  • Java · Lição 67 · Básico · Versão: 2
  • Java · Lição 39 · Intermédio · Versão: 2

Fontes