Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / Java

Operacje liczbowe na IntStream

Twórz strumienie wartości `int`, filtruj elementy i sprawdzaj, czym różnią się typy wyników oraz zachowanie zliczania, sumowania i obliczania średniej dla pustego strumienia.

Wersja: Java SE 21

Składnia

import java.util.OptionalDouble;
import java.util.function.IntPredicate;
import java.util.stream.IntStream;

// IntStream method signatures
static IntStream of(int t)
static IntStream of(int... values)
IntStream filter(IntPredicate predicate)
long count()
int sum()
OptionalDouble average()

W Java SE 21 java.util.stream.IntStream przetwarza wartości prymitywne int, a nie obiekty Integer. Statyczna metoda IntStream.of ma dwa przeciążenia: of(int) tworzy strumień sekwencyjny z jednym elementem, a of(int...) tworzy uporządkowany strumień sekwencyjny z podanych wartości. Drugie przeciążenie przyjmuje także tablicę int[] lub zero argumentów, co daje pusty strumień.

IntStream.filter(IntPredicate) jest leniwą operacją pośrednią. Zwraca strumień zawierający tylko elementy, dla których predykat zwraca true. Predykat musi być bezstanowy i nie może ingerować w źródło strumienia. Oznacza to, że nie może modyfikować źródła ani zależeć od stanu, który może się zmieniać w trakcie przetwarzania. W wyrażeniu n -> n % 2 == 0 operator % oblicza resztę z dzielenia przez 2, a == 0 sprawdza, czy ta reszta wynosi zero.

Operacje końcowe mają różne typy wyników: IntStream.count() zwraca liczbę elementów jako long, a IntStream.sum() zwraca sumę jako int. Dla pustego strumienia obie zwracają zero. Suma może przekroczyć zakres int bez zgłoszenia wyjątku; przypisanie wyniku do long nie zapobiegnie przepełnieniu. IntStream.average() zwraca średnią arytmetyczną jako OptionalDouble, który jest pusty, gdy strumień nie ma elementów. orElse(...) pozwala jawnie wskazać wartość zastępczą.

Operacja końcowa zużywa cały potok. Aby wykonać kolejne niezależne obliczenie na tych samych danych, utwórz nowy strumień ze źródła. Ponowne użycie strumienia jest niedozwolone i po wykryciu może spowodować IllegalStateException.

Przykłady

import java.util.OptionalDouble;
import java.util.stream.IntStream;

public class Main {
    public static void main(String[] args) {
        int[] values = {2, 3, 7, 10};

        long count = IntStream.of(values).count();
        int sum = IntStream.of(values).sum();
        OptionalDouble average = IntStream.of(values).average();
        int evenSum = IntStream.of(values).filter(n -> n % 2 == 0).sum();
        OptionalDouble negativeAverage = IntStream.of(values)
                .filter(n -> n < 0)
                .average();

        System.out.println("count = " + count);
        System.out.println("sum = " + sum);
        System.out.println("average = " + average.orElse(Double.NaN));
        System.out.println("even sum = " + evenSum);
        System.out.println("negative average = " + negativeAverage.orElse(Double.NaN));
    }
}

Wynik

count = 4
sum = 22
average = 5.5
even sum = 12
negative average = NaN

Każde obliczenie zaczyna się od nowego `IntStream.of(values)`. Filtr liczb parzystych pozostawia `2` i `10`. Filtr liczb ujemnych nie znajduje żadnego elementu, więc `NaN` pochodzi z jawnej wartości zastępczej, a nie z `average()`.

Powiązane lekcje

  • Java · Lekcja 46 · Średniozaawansowany · Wersja: 2

Źródła