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