CKTIS / Java
Stream.reduce: praktická referencia
Stream.reduce: praktická referencia: Stream.reduce vykonáva terminálnu asociatívnu redukciu: variant s identity vracia pre prázdny stream identity, variant bez nej Optional.empty().
Verzia: Java SE 21 (JLS and Java SE API); examples verified on the repository Java runtime
Syntax
Stream.reduce(...)Stream.reduce vykonáva terminálnu asociatívnu redukciu: variant s identity vracia pre prázdny stream identity, variant bez nej Optional.empty().
Použi reduce na nemenné skladanie, napríklad súčet či maximum; pre meniteľný kontajner zvoľ collect s oddelenými čiastkovými výsledkami.
Accumulator a combiner musia byť associative, stateless a non-interfering a identity neutrálna; porušenie zákonov dá v paralelnom behu iné výsledky.
Trojargumentový variant vyžaduje kompatibilitu combiner s accumulator; variant s Optional vyhodí NullPointerException, ak je výsledok redukcie null.
Redukcia začne s identity 0 a cez Integer::sum pripočíta 1, 2 a 3; jediný riadok stdout 6 potvrdzuje akumulovaný výsledok.
Príklady
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);
}
}
Výsledok
6
Redukcia začne s identity 0 a cez Integer::sum pripočíta 1, 2 a 3; jediný riadok stdout 6 potvrdzuje akumulovaný výsledok.