Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

CKTIS / Java

Stream.reduce: referência prática

Stream.reduce: referência prática: Stream.reduce executa uma redução terminal associativa: com identity um stream vazio devolve identity, sem ela devolve Optional.empty().

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

Sintaxe

Stream.reduce(...)

Stream.reduce executa uma redução terminal associativa: com identity um stream vazio devolve identity, sem ela devolve Optional.empty().

Usa reduce para folding imutável, como soma ou máximo; para um contentor mutável usa collect com resultados parciais isolados.

Accumulator e combiner têm de ser associative, stateless e non-interfering, e identity neutra; violar estas leis altera resultados em paralelo.

A sobrecarga de três argumentos exige compatibilidade entre combiner e accumulator; a que devolve Optional lança NullPointerException se o resultado reduzido for null.

A redução começa em identity 0 e soma 1, 2 e 3 com Integer::sum; a única linha de stdout, 6, confirma o resultado acumulado.

Exemplos

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

Resultado

6

A redução começa em identity 0 e soma 1, 2 e 3 com Integer::sum; a única linha de stdout, 6, confirma o resultado acumulado.

Fontes