Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / Java

DoubleSummaryStatistics — statystyki wartości double

DoubleSummaryStatistics zbiera liczbę wartości double, sumę, minimum, maksimum i średnią. accept dodaje wartość, a combine scala statystyki.

Wersja: Java SE 21; repository runtime, production runtime not attested

Składnia

DoubleSummaryStatistics stats = new DoubleSummaryStatistics();
stats.accept(value);
stats.combine(other);
stats.getCount();
stats.getSum();
stats.getMin();
stats.getMax();
stats.getAverage();

java.util.DoubleSummaryStatistics to mutowalny akumulator. accept(double) rejestruje wartość; combine(other) dołącza statystyki do bieżącego obiektu.

getCount() zwraca long; getSum(), getMin(), getMax() i getAverage() zwracają double. Pusty obiekt ma licznik, sumę i średnią równe zero, minimum Double.POSITIVE_INFINITY oraz maksimum Double.NEGATIVE_INFINITY.

NaN powoduje wynik NaN dla minimum, maksimum, sumy i średniej. Suma i średnia podlegają błędom zmiennoprzecinkowym; kolejność sumowania nie jest określona.

Obiekt nie jest bezpieczny wątkowo: nie aktualizuj wspólnej instancji równocześnie bez synchronizacji.

Przykłady

import java.util.DoubleSummaryStatistics;

public class Main {
    public static void main(String[] args) {
        DoubleSummaryStatistics stats = new DoubleSummaryStatistics();
        stats.accept(2.0);
        stats.accept(4.0);

        DoubleSummaryStatistics other = new DoubleSummaryStatistics();
        other.accept(6.0);
        stats.combine(other);

        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=12.0
min=2.0
max=6.0
average=4.0

Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.

Źródła