Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / Java

DoubleStream — filtrowanie, zliczanie i średnia

DoubleStream przetwarza prymitywne wartości double w leniwym potoku. Poznaj tworzenie strumienia, filtrowanie oraz operacje kończące count() i average().

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

Składnia

static DoubleStream of(double t)
static DoubleStream of(double... values)
DoubleStream filter(DoublePredicate predicate)
long count()
OptionalDouble average()

java.util.stream.DoubleStream to strumień prymitywnych wartości double, a nie obiektów Double jak w Stream<Double>. Nie przechowuje danych: opisuje ich przetwarzanie. DoubleStream.of(double t) tworzy sekwencyjny strumień jednego elementu, a DoubleStream.of(double... values) — sekwencyjny, uporządkowany strumień podanych wartości.

DoubleStream.filter(DoublePredicate predicate) jest leniwą operacją pośrednią: zachowuje wartości spełniające warunek. Predykat powinien być bezstanowy i nie może modyfikować źródła. Przetwarzanie uruchamia operacja kończąca. DoubleStream.count() zwraca liczbę elementów jako long; dla pustego strumienia wynikiem jest 0.

DoubleStream.average() to operacja kończąca zwracająca średnią arytmetyczną w OptionalDouble. Pusty strumień daje pusty wynik opcjonalny, nie średnią równą zeru. orElse(-1.0) jawnie wybiera wartość zastępczą. Obliczenia zmiennoprzecinkowe mogą podlegać zaokrągleniom; średnia może też być NaN.

Po operacji kończącej potok jest zużyty: nie wywołuj count() i average() na tym samym strumieniu. Przykład tworzy dwa osobne strumienie. Po filtrowaniu pozostają 2.0, 4.0, 6.0, więc oczekiwane wyniki to 3 i 4.0.

Przykłady

import java.util.OptionalDouble;
import java.util.stream.DoubleStream;

public class Main {
    public static void main(String[] args) {
        long count = DoubleStream.of(1.0, 2.0, 4.0, 6.0)
                .filter(x -> x >= 2.0)
                .count();

        OptionalDouble average = DoubleStream.of(1.0, 2.0, 4.0, 6.0)
                .filter(x -> x >= 2.0)
                .average();

        System.out.println("count=" + count);
        System.out.println("average=" + average.orElse(-1.0));
    }
}

Wynik

count=3
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