Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

CKTIS / Java

Statistiky hodnot double pomocí Collectors.summarizingDouble

Získejte počet, součet, minimum, maximum a průměr při jediném průchodu proudem objektů. Stačí určit, jak z každého prvku získat hodnotu typu double.

Verze: Java SE 21

Syntaxe

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

Collectors.summarizingDouble() je zkrácené označení statické metody třídy java.util.stream.Collectors. Nemá přetížení bez argumentů: vyžaduje funkci ToDoubleFunction<? super T>, která z každého prvku proudu získá jednu hodnotu primitivního typu double. Funkci lze předat jako lambda výraz nebo referenci na metodu.

Volání vytvoří kolektor. Předejte ho koncové operaci Stream.collect(...), která v jediném průchodu vrátí objekt java.util.DoubleSummaryStatistics. getCount() vrací počet hodnot jako long; getSum(), getMin(), getMax() a getAverage() vracejí součet, minimum, maximum a aritmetický průměr jako double. Pokud už máte DoubleStream, zavolejte na něm summaryStatistics() bez mapovací funkce.

U prázdného proudu je počet 0, součet a průměr jsou 0.0, minimum je Double.POSITIVE_INFINITY a maximum je Double.NEGATIVE_INFINITY. Ověřte getCount() == 0, než budete minimum a maximum považovat za skutečné hodnoty z dat.

Kvůli zaokrouhlování v pohyblivé řádové čárce mohou součet a průměr záviset na pořadí sčítání. Pokud je některá hodnota získaná mapováním NaN, budou součet, minimum, maximum i průměr NaN; tato hodnota se přesto započítá do počtu.

Příklady

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

Výsledek

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

`Parcel::weightKg` získá hmotnost každé zásilky v kilogramech. Kolektor spočítá tři hodnoty a vypočítá jejich statistiky; příklad vypíše každý výsledek zvlášť.

Související lekce

  • Java · Lekce 67 · Základní · Verze: 2

Zdroje