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

CKTIS / Java

Estatísticas de valores double com Collectors.summarizingDouble

Obtém a contagem, a soma, o mínimo, o máximo e a média numa única passagem por um fluxo de objetos, indicando como extrair um double de cada elemento.

Versão: Java SE 21

Sintaxe

public static <T> Collector<T, ?, DoubleSummaryStatistics> summarizingDouble(ToDoubleFunction<? super T> mapper)

Collectors.summarizingDouble() é uma forma abreviada de referir o método estático de java.util.stream.Collectors. Não existe uma sobrecarga sem argumentos: o método requer uma ToDoubleFunction<? super T> que produza um double primitivo para cada elemento do fluxo. Podes passar a função como uma expressão lambda ou uma referência a um método.

A chamada cria um coletor. Passa-o à operação terminal Stream.collect(...) para obter um objeto java.util.DoubleSummaryStatistics numa única passagem. getCount() devolve a contagem como long; getSum(), getMin(), getMax() e getAverage() devolvem a soma, o mínimo, o máximo e a média aritmética como valores double. Se já tiveres um DoubleStream, chama o seu método summaryStatistics() sem função de transformação.

Se o fluxo estiver vazio, a contagem é 0, a soma e a média são 0.0, o mínimo é Double.POSITIVE_INFINITY e o máximo é Double.NEGATIVE_INFINITY. Verifica getCount() == 0 antes de interpretares o mínimo e o máximo como valores presentes nos dados.

Devido ao arredondamento em vírgula flutuante, a soma e a média podem depender da ordem das adições. Se algum valor produzido pela função for NaN, a soma, o mínimo, o máximo e a média serão NaN; esse valor continua a ser contabilizado.

Exemplos

import java.util.DoubleSummaryStatistics;
import java.util.List;
import java.util.stream.Collectors;

public class Main {
    record Parcel(double weightKg) {}

    public static void main(String[] args) {
        List<Parcel> parcels = List.of(
                new Parcel(1.5), new Parcel(2.5), new Parcel(3.5));

        DoubleSummaryStatistics stats = parcels.stream()
                .collect(Collectors.summarizingDouble(Parcel::weightKg));

        System.out.println("count=" + stats.getCount());
        System.out.println("sum=" + stats.getSum());
        System.out.println("min=" + stats.getMin());
        System.out.println("max=" + stats.getMax());
        System.out.println("average=" + stats.getAverage());
    }
}

Resultado

count=3
sum=7.5
min=1.5
max=3.5
average=2.5

`Parcel::weightKg` extrai o peso de cada encomenda em quilogramas. O coletor conta os três valores e calcula as respetivas estatísticas; o exemplo escreve cada resultado separadamente.

Lições relacionadas

  • Java · Lição 67 · Básico · Versão: 2

Fontes