KennisbankExamencentrum
NL · NLNederlands (Nederland)
Taal kiezen13

CKTIS / Java

Statistieken voor double-waarden met Collectors.summarizingDouble

Bereken het aantal, de som, het minimum, het maximum en het gemiddelde in één doorgang door een objectstream door elk element om te zetten in een double.

Versie: Java SE 21

Syntax

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

Collectors.summarizingDouble() is een verkorte notatie voor de statische methode in java.util.stream.Collectors. Er bestaat geen overload zonder argumenten: je geeft een ToDoubleFunction<? super T> mee die voor elk streamelement één primitieve double oplevert. Die functie kan een lambda-expressie of een methodereferentie zijn.

De aanroep maakt een collector. Geef die door aan de terminale bewerking Stream.collect(...) om in één doorgang een java.util.DoubleSummaryStatistics te krijgen. getCount() geeft het aantal als long; getSum(), getMin(), getMax() en getAverage() geven de som, het minimum, het maximum en het rekenkundig gemiddelde als double. Heb je al een DoubleStream, roep dan daarop summaryStatistics() aan zonder omzetfunctie.

Bij een lege stream is het aantal 0, zijn de som en het gemiddelde 0.0, is het minimum Double.POSITIVE_INFINITY en is het maximum Double.NEGATIVE_INFINITY. Controleer getCount() == 0 voordat je het minimum en maximum als werkelijke waarden uit de gegevens behandelt.

Door afronding bij berekeningen met drijvende komma kunnen de som en het gemiddelde afhangen van de volgorde van optellen. Als een van de waarden uit de omzetfunctie NaN is, zijn de som, het minimum, het maximum en het gemiddelde ook NaN; die waarde telt wel mee voor het aantal.

Voorbeelden

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

Resultaat

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

`Parcel::weightKg` haalt het gewicht van elk pakket in kilogram op. De collector telt de drie waarden en berekent hun statistieken; het voorbeeld drukt elk resultaat afzonderlijk af.

Gerelateerde lessen

  • Java · Les 67 · Basis · Versie: 2

Bronnen