Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / Java

Stream.reduce: praktyczna referencja

Stream.reduce: praktyczna referencja: Stream.reduce wykonuje terminalną redukcję asocjacyjną: wariant z identity zwraca identity dla pustego strumienia, a wariant bez niej zwraca Optional.empty().

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

Składnia

Stream.reduce(...)

Stream.reduce wykonuje terminalną redukcję asocjacyjną: wariant z identity zwraca identity dla pustego strumienia, a wariant bez niej zwraca Optional.empty().

Stosuj reduce do niemutowalnego składania, na przykład sumy lub maksimum; dla mutowalnego kontenera wybierz collect z osobnymi wynikami częściowymi.

Accumulator i combiner muszą być associative, stateless i non-interfering, a identity neutralne; naruszenie praw ujawnia różne wyniki w wykonaniu równoległym.

Trzeci overload wymaga zgodności combiner z accumulator; wariant zwracający Optional zgłasza NullPointerException, jeśli wynik redukcji jest null.

Redukcja zaczyna od identity 0 i dodaje 1, 2 oraz 3 przez Integer::sum; jedyny wiersz stdout, 6, potwierdza wynik akumulacji.

Przykłady

public class Main {
    public static void main(String[] args) throws Exception {
        int sum = java.util.stream.Stream.of(1, 2, 3).reduce(0, Integer::sum);
        System.out.println(sum);
    }
}

Wynik

6

Redukcja zaczyna od identity 0 i dodaje 1, 2 oraz 3 przez Integer::sum; jedyny wiersz stdout, 6, potwierdza wynik akumulacji.

Źródła