CKTIS / Java
Einen Stream mit Stream.toArray(IntFunction) in ein typisiertes Array umwandeln
Sammle die Elemente eines Streams in einem Array des gewünschten Typs, etwa `String[]`. Übergib dazu eine Funktion, die ein Array der angeforderten Länge erstellt.
Version: Java SE 21
Syntax
<A> A[] toArray(java.util.function.IntFunction<A[]> generator)In Java SE 21 sammelt Stream.toArray(IntFunction) aus java.util.stream.Stream<T> die Ergebniselemente der Pipeline in einem A[]. Die Methode ist eine terminale Operation: Danach kannst du denselben Stream nicht erneut verwenden. Hat der Stream eine festgelegte Elementreihenfolge, bleibt sie im Array erhalten.
Der Generator java.util.function.IntFunction<A[]> erhält die Länge als int und gibt ein neues Array dieser Länge zurück. String[]::new bedeutet hier dasselbe wie length -> new String[length]. Der Stream gibt die Größe vor; geh nicht davon aus, dass er den Generator nur einmal aufruft. Bei der Aufteilung der Verarbeitung oder bei Größenänderungen können zusätzliche Arrays nötig sein.
Das parameterlose toArray() liefert ein Object[] mit dem Laufzeit-Komponententyp Object, selbst bei einem Stream<String>. In der Überladung mit Generator ist A der Komponententyp des Arrays, unabhängig vom Elementtyp T des Streams. Die Methode wandelt keine Elemente um: Lässt sich ein Element wegen des Laufzeit-Komponententyps nicht im Array speichern, löst sie eine ArrayStoreException aus.
Beispiele
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));
}
}
Ergebnis
[Ada, Clara]
`filter` schließt `Bo` aus, weil der Name weniger als 3 Zeichen hat. Mit `String[]::new` lässt sich das Ergebnis ohne Typumwandlung `String[]` zuweisen. `Arrays.toString` zeigt `[Ada, Clara]` an.
Zugehörige Lektionen
- Java · Lektion 63 · Grundlagen · Version: 2