CKTIS / Java
Stream.peek: praktická referencia
Stream.peek: praktická referencia: Stream.peek(action) je lenivá medzilehlá operácia, ktorá odovzdáva rovnaké prvky ďalej a volá Consumer, keď ich nadväzujúci prechod spotrebúva.
Verzia: Java SE 21 (JLS and Java SE API); examples verified on the repository Java runtime
Syntax
Stream.peek(...)Stream.peek(action) je lenivá medzilehlá operácia, ktorá odovzdáva rovnaké prvky ďalej a volá Consumer, keď ich nadväzujúci prechod spotrebúva.
Použi peek najmä na diagnostiku hodnôt medzi stupňami pipeline; povinné koncové účinky vykonávaj cez forEach alebo forEachOrdered.
Optimalizácia alebo skrátené vyhodnotenie môže niektoré či všetky volania vynechať; v paralelnej pipeline môže akcia bežať v rôznych vláknach.
Akcia musí byť non-interfering a nesmie byť null; zdieľaný stav synchronizuje sama a bez terminálnej operácie sa vôbec nespustí.
Terminálny toList spustí pipeline: peek vypíše presne 1:2:, potom map vytvorí [2, 4], takže celý stdout je 1:2:[2, 4].
Prí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ýsledok
1:2:[2, 4]
Terminálny toList spustí pipeline: peek vypíše presne 1:2:, potom map vytvorí [2, 4], takže celý stdout je 1:2:[2, 4].