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