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

CKTIS / Java

Stream.peek: referencia práctica

Stream.peek: referencia práctica: Stream.peek(action) es una operación intermedia perezosa que deja pasar los mismos elementos e invoca el Consumer cuando el recorrido posterior los consume.

Versión: Java SE 21 (JLS and Java SE API); examples verified on the repository Java runtime

Sintaxis

Stream.peek(...)

Stream.peek(action) es una operación intermedia perezosa que deja pasar los mismos elementos e invoca el Consumer cuando el recorrido posterior los consume.

Usa peek sobre todo para diagnosticar valores entre etapas del pipeline; realiza efectos terminales obligatorios con forEach o forEachOrdered.

Una optimización o un cortocircuito puede omitir algunas o todas las invocaciones; en un pipeline paralelo la acción puede ejecutarse en varios hilos.

La acción debe ser non-interfering y no null; ella misma sincroniza el estado compartido y no se ejecuta en absoluto sin una operación terminal.

El toList terminal impulsa el pipeline: peek escribe exactamente 1:2:, luego map produce [2, 4]; la salida completa es 1:2:[2, 4].

Ejemplos

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]

El toList terminal impulsa el pipeline: peek escribe exactamente 1:2:, luego map produce [2, 4]; la salida completa es 1:2:[2, 4].

Fuentes