Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / Java

Arrays.stream(T[]): strumień z tablicy

Utwórz sekwencyjny strumień z tablicy elementów typu referencyjnego, przefiltruj je i zapisz wynik w tablicy o odpowiednim typie.

Wersja: Java SE 21

Składnia

public static <T> Stream<T> stream(T[] array)

Arrays.stream(T[]) to statyczna metoda klasy java.util.Arrays, dostępna od Javy 8. Z tablicy elementów typu referencyjnego tworzy sekwencyjny strumień java.util.stream.Stream<T> w kolejności indeksów. Na przykład String[] daje Stream<String>. Metoda nie kopiuje tablicy źródłowej; przekazanie null zamiast tablicy powoduje NullPointerException.

Operacje pośrednie, takie jak filter, są leniwe: przetwarzanie rozpoczyna się po wywołaniu operacji końcowej, takiej jak toArray(). Nie modyfikuj tablicy źródłowej podczas przetwarzania. Po operacji końcowej nie używaj ponownie tego samego strumienia. Jeśli chcesz przetworzyć tablicę jeszcze raz, utwórz nowy strumień.

Przeciążenie z zakresem, Arrays.stream(array, startInclusive, endExclusive), obejmuje indeks początkowy, ale nie końcowy. Wymaga 0 <= startInclusive <= endExclusive <= array.length; nieprawidłowe granice powodują ArrayIndexOutOfBoundsException. Przeciążenia dla int[], long[] i double[] zwracają odpowiednio IntStream, LongStream i DoubleStream. Dla innych jednowymiarowych tablic typów prostych, takich jak boolean[], nie ma bezpośredniego przeciążenia.

W przypadku Stream<T> deklarowanym typem zwracanym przez bezargumentową metodę toArray() jest Object[], ale Java SE 21 nie określa dokładnej klasy zwracanej tablicy w czasie wykonania. Nie rzutuj wyniku na String[]; jeśli potrzebujesz właśnie takiej tablicy, użyj toArray(String[]::new) na strumieniu napisów.

W kodzie korzystającym z refleksji możesz przekazać otrzymaną tablicę Object[] do Constructor.newInstance(Object...). Jej elementy stają się kolejnymi argumentami wybranego konstruktora. Ich liczba, kolejność i typy muszą odpowiadać jego parametrom z uwzględnieniem dozwolonych konwersji. Niezgodna liczba lub typ argumentów powoduje IllegalArgumentException.

Przykłady

import java.util.Arrays;

public class Main {
    public record Pair(String first, String second) {}

    public static void main(String[] args) throws ReflectiveOperationException {
        String[] input = {"Ada", " ", "Lin"};
        Object[] arguments = Arrays.stream(input)
                .filter(name -> !name.isBlank())
                .toArray();

        Pair pair = Pair.class.getConstructor(String.class, String.class)
                .newInstance(arguments);

        System.out.println(Arrays.toString(arguments));
        System.out.println(pair.first() + " / " + pair.second());
    }
}

Wynik

[Ada, Lin]
Ada / Lin

`filter` odrzuca napis złożony z jednej spacji. `toArray()` zapisuje `Ada` i `Lin` w tablicy `Object[]` w tej kolejności, a `newInstance` przekazuje je jako dwa argumenty konstruktora `Pair`.

Powiązane lekcje

  • Java · Lekcja 59 · Zaawansowany · Wersja: 2
  • Java · Lekcja 63 · Podstawowy · Wersja: 2

Źródła