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

CKTIS / Java

Map.forEach: una acción por cada par clave-valor

`Map.forEach` recorre directamente las entradas de un mapa. Pasa dos argumentos a un `BiConsumer`: primero la clave y después el valor asociado.

Versión: Java SE 21

Sintaxis

default void forEach(BiConsumer<? super K, ? super V> action)

Map.forEach es un método por defecto de la interfaz java.util.Map<K, V>, disponible desde Java 8. Recibe un BiConsumer<? super K, ? super V> y llama a accept(key, value) para cada entrada. Puedes expresar la acción con una lambda (key, value) -> .... Ni la acción ni el método devuelven un resultado (void).

Map.forEach actúa directamente sobre el mapa. En cambio, Stream.forEach es una operación terminal de un flujo que recibe un Consumer con un argumento por elemento. En map.entrySet().stream().forEach(...), ese argumento es un objeto Map.Entry, no dos argumentos separados.

Si el mapa tiene un orden de iteración definido, las acciones siguen el orden de iteración de entrySet(), salvo que la implementación indique lo contrario. No des por hecho que todos los mapas conservan el orden de inserción: HashMap no lo garantiza.

Si la acción lanza una excepción, el recorrido se detiene y la excepción se propaga al código que llamó al método. Una acción null provoca una NullPointerException. Evita añadir o eliminar entradas dentro de la acción: si se detecta una eliminación durante el recorrido, puede producirse una ConcurrentModificationException. La implementación por defecto no garantiza ni la sincronización ni la atomicidad.

Ejemplos

import java.util.LinkedHashMap;
import java.util.Map;

public class Main {
    public static void main(String[] args) {
        Map<String, Integer> stock = new LinkedHashMap<>();
        stock.put("pear", 3);
        stock.put("apple", 5);

        stock.forEach((key, value) -> System.out.println(key + ": " + value));
    }
}

Resultado

pear: 3
apple: 5

La lambda recibe una clave de tipo `String` y un valor de tipo `Integer`. `new LinkedHashMap<>()` conserva el orden de inserción, así que `pear` aparece antes que `apple`.

Lecciones relacionadas

  • Java · Lección 42 · Intermedio · Versión: 2

Fuentes