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