Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

CKTIS / Java

Stream.peek: praktická reference

Stream.peek: praktická reference: Stream.peek(action) je líná mezilehlá operace, která předává stejné prvky dál a volá Consumer, když je navazující průchod spotřebovává.

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

Syntaxe

Stream.peek(...)

Stream.peek(action) je líná mezilehlá operace, která předává stejné prvky dál a volá Consumer, když je navazující průchod spotřebovává.

Použij peek hlavně k diagnostice hodnot mezi stupni pipeline; povinné koncové účinky prováděj přes forEach nebo forEachOrdered.

Optimalizace nebo zkrácené vyhodnocení může některá či všechna volání vynechat; v paralelní pipeline může akce běžet v různých vláknech.

Akce musí být non-interfering a nesmí být null; sdílený stav synchronizuje sama a bez terminální operace se vůbec nespustí.

Terminální toList spustí pipeline: peek vypíše přesně 1:2:, poté map vytvoří [2, 4], takže celý stdout je 1:2:[2, 4].

Příklady

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

Výsledek

1:2:[2, 4]

Terminální toList spustí pipeline: peek vypíše přesně 1:2:, poté map vytvoří [2, 4], takže celý stdout je 1:2:[2, 4].

Zdroje