KennisbankExamencentrum
NL · NLNederlands (Nederland)
Taal kiezen13

CKTIS / Java

Stream.peek: praktische referentie

Stream.peek: praktische referentie: Stream.peek(action) is een luie tussenbewerking die dezelfde elementen doorgeeft en de Consumer aanroept wanneer verdere doorloop ze verbruikt.

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

Syntax

Stream.peek(...)

Stream.peek(action) is een luie tussenbewerking die dezelfde elementen doorgeeft en de Consumer aanroept wanneer verdere doorloop ze verbruikt.

Gebruik peek vooral om waarden tussen pijplijnstappen te onderzoeken; voer vereiste eindeffecten uit met forEach of forEachOrdered.

Optimalisatie of kortsluiting kan sommige of alle aanroepen overslaan; in een parallelle pijplijn kan de actie in verschillende threads draaien.

De actie moet non-interfering en niet null zijn; zij moet gedeelde toestand zelf synchroniseren en draait helemaal niet zonder terminale bewerking.

De terminale toList drijft de pijplijn: peek schrijft precies 1:2:, daarna levert map [2, 4]; de volledige uitvoer is 1:2:[2, 4].

Voorbeelden

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

Resultaat

1:2:[2, 4]

De terminale toList drijft de pijplijn: peek schrijft precies 1:2:, daarna levert map [2, 4]; de volledige uitvoer is 1:2:[2, 4].

Bronnen