Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / Java

Zamiana strumienia na tablicę za pomocą Stream.toArray(IntFunction)

Zbierz elementy strumienia do tablicy o wybranym typie, np. `String[]`, przekazując funkcję, która tworzy tablicę o żądanej długości.

Wersja: Java SE 21

Składnia

<A> A[] toArray(java.util.function.IntFunction<A[]> generator)

W Java SE 21 metoda Stream.toArray(IntFunction) z interfejsu java.util.stream.Stream<T> zbiera elementy wynikowe potoku do tablicy A[]. Jest to operacja terminalna: po jej wykonaniu nie można ponownie użyć tego samego strumienia. Jeśli strumień ma ustaloną kolejność napotykania elementów, tablica ją zachowuje.

Generator java.util.function.IntFunction<A[]> otrzymuje długość jako int i zwraca nową tablicę o tej długości. Zapis String[]::new oznacza tu to samo co length -> new String[length]. Rozmiar podaje strumień; nie zakładaj, że generator zostanie wywołany tylko raz. Dodatkowe tablice mogą być potrzebne przy przetwarzaniu podzielonym na części lub przy zmianie rozmiaru.

Bezargumentowe toArray() zwraca Object[], którego typem składowym w czasie działania jest Object, nawet dla Stream<String>. W przeciążeniu z generatorem A to typ składowy tablicy, niezależny od typu elementów strumienia T. Metoda nie konwertuje elementów: jeśli któregoś nie można zapisać w tablicy ze względu na jej rzeczywisty typ składowy, metoda zgłasza ArrayStoreException.

Przykłady

import java.util.Arrays;
import java.util.stream.Stream;

public class StreamToArrayExample {
    public static void main(String[] args) {
        String[] names = Stream.of("Ada", "Bo", "Clara")
                .filter(name -> name.length() >= 3)
                .toArray(String[]::new);

        System.out.println(Arrays.toString(names));
    }
}

Wynik

[Ada, Clara]

`filter` usuwa `Bo`, ponieważ ta nazwa ma mniej niż 3 znaki. `String[]::new` pozwala przypisać wynik bez rzutowania do `String[]`, a `Arrays.toString` wyświetla `[Ada, Clara]`.

Powiązane lekcje

  • Java · Lekcja 63 · Podstawowy · Wersja: 2

Źródła