Base de connaissancesCentre d’examen
FRFrançais
Choisir la langue13

CKTIS / Java

Stream.peek: référence pratique

Stream.peek: référence pratique: Stream.peek(action) est une opération intermédiaire paresseuse qui transmet les mêmes éléments et appelle le Consumer lorsque le parcours aval les consomme.

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

Syntaxe

Stream.peek(...)

Stream.peek(action) est une opération intermédiaire paresseuse qui transmet les mêmes éléments et appelle le Consumer lorsque le parcours aval les consomme.

Utilise peek surtout pour diagnostiquer les valeurs entre étapes du pipeline ; confie les effets terminaux requis à forEach ou forEachOrdered.

Une optimisation ou un court-circuit peut omettre certains appels, voire tous ; dans un pipeline parallèle, l’action peut s’exécuter sur plusieurs threads.

L’action doit être non-interfering et non null ; elle doit synchroniser elle-même tout état partagé et ne s’exécute jamais sans opération terminale.

Le toList terminal déclenche le pipeline : peek écrit exactement 1:2:, puis map produit [2, 4] ; la sortie complète est 1:2:[2, 4].

Exemples

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

Résultat

1:2:[2, 4]

Le toList terminal déclenche le pipeline : peek écrit exactement 1:2:, puis map produit [2, 4] ; la sortie complète est 1:2:[2, 4].

Sources