Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / Java

Statystyki wartości double z Collectors.summarizingDouble

Zbierz liczbę wartości, sumę, minimum, maksimum i średnią w jednym przebiegu strumienia obiektów, wskazując, jak uzyskać wartość double z każdego elementu.

Wersja: Java SE 21

Składnia

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

Collectors.summarizingDouble() to skrócony zapis nazwy statycznej metody z klasy java.util.stream.Collectors. Metoda nie ma wariantu bezargumentowego: wymaga funkcji ToDoubleFunction<? super T>, która z każdego elementu strumienia wyznacza jedną wartość typu prostego double. Funkcję można przekazać jako lambdę lub referencję do metody.

Samo wywołanie tworzy kolektor. Przekaż go do operacji końcowej Stream.collect(...), aby w jednym przebiegu otrzymać obiekt java.util.DoubleSummaryStatistics. getCount() zwraca liczbę wartości jako long, a getSum(), getMin(), getMax() i getAverage() zwracają odpowiednio sumę, minimum, maksimum i średnią arytmetyczną jako double. Jeśli masz już DoubleStream, wywołaj na nim summaryStatistics() bez funkcji mapującej.

Dla pustego strumienia liczba wartości wynosi 0, suma i średnia to 0.0, minimum to Double.POSITIVE_INFINITY, a maksimum to Double.NEGATIVE_INFINITY. Sprawdź getCount() == 0, zanim zinterpretujesz minimum i maksimum jako rzeczywiste wartości z danych.

Z powodu zaokrągleń zmiennoprzecinkowych suma i średnia mogą zależeć od kolejności dodawania. Jeśli choć jedna z wartości uzyskanych przez mapowanie to NaN, suma, minimum, maksimum i średnia będą NaN; ta wartość nadal wlicza się do liczby wartości.

Przykłady

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

Wynik

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

`Parcel::weightKg` pobiera masę każdej paczki w kilogramach. Kolektor zlicza trzy wartości i oblicza ich statystyki; przykład wypisuje każdy wynik osobno.

Powiązane lekcje

  • Java · Lekcja 67 · Podstawowy · Wersja: 2

Źródła