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

CKTIS / Java

Map.forEach: uma ação por cada par chave-valor

`Map.forEach` percorre diretamente as entradas de um mapa. Passa dois argumentos a um `BiConsumer`: primeiro a chave, depois o valor associado.

Versão: Java SE 21

Sintaxe

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

Map.forEach é um método predefinido da interface java.util.Map<K, V>, disponível desde o Java 8. Recebe um BiConsumer<? super K, ? super V> e chama accept(key, value) para cada entrada. Podes escrever a ação como uma expressão lambda (key, value) -> .... Nem a ação nem o método devolvem um resultado (void).

Map.forEach opera diretamente sobre o mapa. Já Stream.forEach é uma operação terminal de um fluxo que recebe um Consumer com um argumento por elemento. Em map.entrySet().stream().forEach(...), esse argumento é um objeto Map.Entry, não dois argumentos separados.

Se o mapa tiver uma ordem de iteração definida, as ações seguem a ordem de iteração de entrySet(), salvo indicação em contrário da implementação. Não assumas que todos os mapas mantêm a ordem de inserção: HashMap não a garante.

Se a ação lançar uma exceção, a iteração termina e a exceção propaga-se para o código que chamou o método. Uma ação null provoca uma NullPointerException. Evita adicionar ou remover entradas dentro da ação: uma remoção detetada durante a iteração pode provocar uma ConcurrentModificationException. A implementação predefinida não garante sincronização nem atomicidade.

Exemplos

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

A expressão lambda recebe uma chave do tipo `String` e um valor do tipo `Integer`. `new LinkedHashMap<>()` mantém a ordem de inserção, pelo que `pear` aparece antes de `apple`.

Lições relacionadas

  • Java · Lição 42 · Intermédio · Versão: 2

Fontes