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

CKTIS / Java

Stream.peek: referência prática

Stream.peek: referência prática: Stream.peek(action) é uma operação intermédia lazy que encaminha os mesmos elementos e chama o Consumer quando o percurso a jusante os consome.

Versão: Java SE 21 (JLS and Java SE API); examples verified on the repository Java runtime

Sintaxe

Stream.peek(...)

Stream.peek(action) é uma operação intermédia lazy que encaminha os mesmos elementos e chama o Consumer quando o percurso a jusante os consome.

Usa peek sobretudo para diagnosticar valores entre etapas do pipeline; executa efeitos terminais obrigatórios com forEach ou forEachOrdered.

Uma otimização ou curto-circuito pode omitir algumas ou todas as chamadas; num pipeline paralelo a ação pode correr em threads diferentes.

A ação tem de ser non-interfering e não null; deve sincronizar o estado partilhado e não é executada sem uma operação terminal.

O toList terminal executa o pipeline: peek escreve exatamente 1:2:, depois map produz [2, 4]; o stdout completo é 1:2:[2, 4].

Exemplos

public class Main {
    public static void main(String[] args) throws Exception {
        var result = java.util.stream.Stream.of(1, 2).peek(n -> System.out.print(n + ":")).map(n -> n * 2).toList();
        System.out.println(result);
    }
}

Resultado

1:2:[2, 4]

O toList terminal executa o pipeline: peek escreve exatamente 1:2:, depois map produz [2, 4]; o stdout completo é 1:2:[2, 4].

Fontes