Base de conocimientosCentro de exámenes
ESEspañol
Elegir idioma13

CKTIS / Java

Map.entrySet(): recorrer pares clave-valor

Usa `entrySet()` cuando necesites tanto la clave como su valor asociado en cada vuelta del bucle. El método devuelve una vista del mapa, no una copia.

Versión: Java SE 21

Sintaxis

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 un método de instancia sin argumentos de java.util.Map<K, V>. La notación Map.entrySet() se refiere al mismo método con su lista de argumentos vacía; en el código, llámalo sobre una instancia con map.entrySet(). Devuelve un Set<Map.Entry<K, V>> con una entrada por cada asociación.

Map.Entry<K, V> es una interfaz anidada en Map. En un bucle for mejorado, llama a entry.getKey() para leer la clave de tipo K y a entry.getValue() para leer el valor de tipo V de cada entrada. No hace falta otra consulta con map.get(key). Si solo necesitas las claves, usa keySet(); si solo necesitas los valores, usa values().

El conjunto es una vista vinculada al mapa, no una copia instantánea: los cambios en el mapa se reflejan en la vista y, si se admite la eliminación desde la vista, esta también elimina la asociación del mapa. add y addAll no se admiten. Según el contrato general de Map, modificar el mapa durante el recorrido deja el resultado indefinido, salvo con operaciones admitidas: Iterator.remove() en el iterador en uso o setValue(...) en una entrada devuelta por ese iterador. No dependas del comportamiento de esa entrada después del recorrido.

entrySet() no ordena las entradas por sí mismo. El orden de recorrido depende de la implementación del mapa. En el ejemplo, new TreeMap<>(counts) crea un mapa independiente con las mismas asociaciones, ordenadas según el orden natural de las claves. El bucle recorre la vista de esa copia.

Ejemplos

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(...)` cuenta las apariciones de cada nombre de fruta. Solo cuando termina, el código crea la copia `TreeMap` e imprime exactamente cinco líneas, una por clave, en el orden natural de las claves.

Lecciones relacionadas

  • Java · Lección 24 · Avanzado · Versión: 2
  • Java · Lección 57 · Básico · Versión: 2
  • Java · Lección 67 · Básico · Versión: 2
  • Java · Lección 39 · Intermedio · Versión: 2

Fuentes