Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / Java

Stream.peek: praktyczna referencja

Stream.peek: praktyczna referencja: Stream.peek(action) jest leniwą operacją pośrednią, która przekazuje te same elementy i wykonuje Consumer, gdy elementy są pobierane przez dalszy potok.

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

Składnia

Stream.peek(...)

Stream.peek(action) jest leniwą operacją pośrednią, która przekazuje te same elementy i wykonuje Consumer, gdy elementy są pobierane przez dalszy potok.

Stosuj peek głównie do diagnostyki wartości między etapami potoku, a wymagane efekty końcowe wykonuj przez forEach lub forEachOrdered.

Optymalizacja albo operacja short-circuit może pominąć część lub wszystkie wywołania; w potoku równoległym akcja może działać w różnych wątkach.

Action musi być non-interfering i nie może być null; modyfikując stan współdzielony, sama zapewnia synchronizację, a bez operacji terminalnej nie wykona się wcale.

Końcowe toList wymusza potok: peek wypisuje dokładnie 1:2:, po czym map daje [2, 4], więc pełny stdout to 1:2:[2, 4].

Przykłady

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

Wynik

1:2:[2, 4]

Końcowe toList wymusza potok: peek wypisuje dokładnie 1:2:, po czym map daje [2, 4], więc pełny stdout to 1:2:[2, 4].

Źródła