Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / Java

Statistiche di valori double con Collectors.summarizingDouble

Ottieni conteggio, somma, minimo, massimo e media in un solo passaggio su uno stream di oggetti, indicando come ricavare un double da ogni elemento.

Versione: Java SE 21

Sintassi

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

Collectors.summarizingDouble() è una notazione abbreviata per il metodo statico di java.util.stream.Collectors. Non esiste un overload senza argomenti: serve una ToDoubleFunction<? super T> che produca un double primitivo per ogni elemento dello stream. Puoi passare la funzione come espressione lambda o come riferimento a un metodo.

La chiamata crea un collector. Passalo all’operazione terminale Stream.collect(...) per ottenere un oggetto java.util.DoubleSummaryStatistics in un solo passaggio. getCount() restituisce il conteggio come long; getSum(), getMin(), getMax() e getAverage() restituiscono somma, minimo, massimo e media aritmetica come valori double. Se hai già un DoubleStream, chiamane il metodo summaryStatistics() senza una funzione di trasformazione.

Se lo stream è vuoto, il conteggio è 0, la somma e la media sono 0.0, il minimo è Double.POSITIVE_INFINITY e il massimo è Double.NEGATIVE_INFINITY. Controlla getCount() == 0 prima di interpretare il minimo e il massimo come valori effettivamente presenti nei dati.

A causa degli arrotondamenti in virgola mobile, la somma e la media possono dipendere dall’ordine delle addizioni. Se uno dei valori prodotti dalla funzione è NaN, anche somma, minimo, massimo e media sono NaN; quel valore viene comunque conteggiato.

Esempi

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

Risultato

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

`Parcel::weightKg` estrae il peso in chilogrammi di ogni pacco. Il collector conta i tre valori e ne calcola le statistiche; l’esempio stampa ogni risultato separatamente.

Lezioni correlate

  • Java · Lezione 67 · Base · Versione: 2

Fonti