Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / Java

Stream.peek: riferimento pratico

Stream.peek: riferimento pratico: Stream.peek(action) è un’operazione intermedia lazy che inoltra gli stessi elementi e invoca il Consumer mentre il percorso a valle li consuma.

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

Sintassi

Stream.peek(...)

Stream.peek(action) è un’operazione intermedia lazy che inoltra gli stessi elementi e invoca il Consumer mentre il percorso a valle li consuma.

Usa peek soprattutto per diagnosticare valori tra fasi della pipeline; esegui gli effetti terminali necessari con forEach o forEachOrdered.

Un’ottimizzazione o uno short-circuit può omettere alcune o tutte le invocazioni; in una pipeline parallela l’azione può girare su thread diversi.

L’azione deve essere non-interfering e non null; deve sincronizzare da sé lo stato condiviso e senza operazione terminale non viene eseguita.

Il toList terminale avvia la pipeline: peek stampa esattamente 1:2:, poi map produce [2, 4]; lo stdout completo è 1:2:[2, 4].

Esempi

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);
    }
}

Risultato

1:2:[2, 4]

Il toList terminale avvia la pipeline: peek stampa esattamente 1:2:, poi map produce [2, 4]; lo stdout completo è 1:2:[2, 4].

Fonti