База знанияИзпитен център
BGБългарски
Избери език13

CKTIS / Java

Статистика за стойности double с Collectors.summarizingDouble

Получете брой, сума, минимум, максимум и средна стойност с едно обхождане на поток от обекти, като зададете как от всеки елемент да се получи стойност double.

Версия: Java SE 21

Синтаксис

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

Collectors.summarizingDouble() е съкратено означение на статичния метод от класа java.util.stream.Collectors. Няма претоварен вариант без аргументи: методът изисква функция ToDoubleFunction<? super T>, която извлича по една стойност от примитивния тип double от всеки елемент на потока. Можете да подадете функцията като ламбда израз или референция към метод.

Извикването създава колектор. Подайте го на крайната операция Stream.collect(...), за да получите обект java.util.DoubleSummaryStatistics с едно обхождане. getCount() връща броя като long, а getSum(), getMin(), getMax() и getAverage() връщат сумата, минимума, максимума и средната аритметична стойност като double. Ако вече разполагате с DoubleStream, извикайте неговия метод summaryStatistics() без преобразуваща функция.

При празен поток броят е 0, сумата и средната стойност са 0.0, минимумът е Double.POSITIVE_INFINITY, а максимумът е Double.NEGATIVE_INFINITY. Проверете getCount() == 0, преди да приемете минимума и максимума за действителни стойности от данните.

Заради закръгляването при аритметика с плаваща запетая сумата и средната стойност може да зависят от реда на събиране. Ако някоя от получените чрез функцията стойности е NaN, сумата, минимумът, максимумът и средната стойност също са NaN; стойността все пак се включва в броя.

Примери

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

Резултат

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

`Parcel::weightKg` извлича теглото на всяка пратка в килограми. Колекторът преброява трите стойности и изчислява статистиката им; примерът отпечатва всеки резултат отделно.

Свързани уроци

  • Java · Урок 67 · Начално · Версия: 2

Източници