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.