WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / Java

Statistik für double-Werte mit Collectors.summarizingDouble

Ermittle Anzahl, Summe, Minimum, Maximum und Mittelwert in einem Durchlauf durch einen Objektstream, indem du jedes Element auf einen double-Wert abbildest.

Version: Java SE 21

Syntax

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

Collectors.summarizingDouble() ist eine Kurzschreibweise für die statische Methode in java.util.stream.Collectors. Es gibt keine Überladung ohne Argumente: Die Methode benötigt eine ToDoubleFunction<? super T>, die für jedes Stream-Element einen primitiven double-Wert liefert. Du kannst die Funktion als Lambda-Ausdruck oder Methodenreferenz übergeben.

Der Methodenaufruf erzeugt einen Collector. Übergib ihn an die terminale Operation Stream.collect(...), um in einem Durchlauf ein Objekt vom Typ java.util.DoubleSummaryStatistics zu erhalten. getCount() liefert die Anzahl als long; getSum(), getMin(), getMax() und getAverage() liefern Summe, Minimum, Maximum und arithmetischen Mittelwert als double. Wenn bereits ein DoubleStream vorliegt, rufe darauf summaryStatistics() ohne Abbildungsfunktion auf.

Bei einem leeren Stream ist die Anzahl 0, Summe und Mittelwert sind 0.0, das Minimum ist Double.POSITIVE_INFINITY und das Maximum Double.NEGATIVE_INFINITY. Prüfe getCount() == 0, bevor du Minimum und Maximum als tatsächliche Werte aus den Daten interpretierst.

Wegen der Gleitkommarundung können Summe und Mittelwert von der Reihenfolge der Additionen abhängen. Ist einer der abgebildeten Werte NaN, so sind Summe, Minimum, Maximum und Mittelwert ebenfalls NaN; der Wert wird trotzdem mitgezählt.

Beispiele

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

Ergebnis

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

`Parcel::weightKg` liest das Gewicht jedes Pakets in Kilogramm aus. Der Collector zählt die drei Werte und berechnet ihre Kennzahlen; das Beispiel gibt jedes Ergebnis einzeln aus.

Zugehörige Lektionen

  • Java · Lektion 67 · Grundlagen · Version: 2

Quellen