CKTIS / Java
Stream.reduce: praktični priročnik
Stream.reduce: praktični priročnik: Stream.reduce izvede končno asociativno redukcijo: različica z identity za prazen stream vrne identity, različica brez nje pa Optional.empty().
Različica: Java SE 21 (JLS and Java SE API); examples verified on the repository Java runtime
Sintaksa
Stream.reduce(...)Stream.reduce izvede končno asociativno redukcijo: različica z identity za prazen stream vrne identity, različica brez nje pa Optional.empty().
Uporabi reduce za nespremenljivo zlaganje, na primer vsoto ali maksimum; za spremenljiv vsebnik izberi collect z ločenimi delnimi rezultati.
Accumulator in combiner morata biti associative, stateless in non-interfering, identity pa nevtralna; kršitev zakonov da pri vzporednem izvajanju druge rezultate.
Različica s tremi argumenti zahteva skladnost combiner z accumulator; različica z Optional sproži NullPointerException, če je rezultat redukcije null.
Redukcija začne z identity 0 in prek Integer::sum prišteje 1, 2 in 3; edina vrstica stdout 6 potrdi zbrani rezultat.
Primeri
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);
}
}
Rezultat
6
Redukcija začne z identity 0 in prek Integer::sum prišteje 1, 2 in 3; edina vrstica stdout 6 potrdi zbrani rezultat.