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