WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

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 Ergebnis­elemente 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

Quellen