KennisbankExamencentrum
NL · NLNederlands (Nederland)
Taal kiezen13

CKTIS / Java

Een stream omzetten in een getypeerde array met Stream.toArray(IntFunction)

Verzamel de elementen van een stream in een array van het gewenste type, zoals `String[]`, met een functie die een array van de gevraagde lengte maakt.

Versie: Java SE 21

Syntax

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

In Java SE 21 verzamelt Stream.toArray(IntFunction) van java.util.stream.Stream<T> de uitvoerelementen van de pipeline in een A[]. Het is een terminale operatie: daarna kun je dezelfde stream niet opnieuw gebruiken. Heeft de stream een vastgelegde volgorde, dan behoudt de array die volgorde.

De generator java.util.function.IntFunction<A[]> krijgt de lengte als int en retourneert een nieuwe array van die lengte. String[]::new betekent hier hetzelfde als length -> new String[length]. De stream geeft de grootte door; ga er niet van uit dat hij de generator maar één keer aanroept. Bij het opdelen van de verwerking of het aanpassen van de grootte kunnen extra arrays nodig zijn.

Zonder argumenten retourneert toArray() een Object[] waarvan het componenttype tijdens runtime Object is, zelfs bij een Stream<String>. Bij de overload met generator is A het componenttype van de array, onafhankelijk van het elementtype T van de stream. De methode converteert geen elementen: ze gooit een ArrayStoreException als het componenttype tijdens runtime verhindert dat een element in de array wordt opgeslagen.

Voorbeelden

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));
    }
}

Resultaat

[Ada, Clara]

`filter` sluit `Bo` uit omdat de naam minder dan 3 tekens heeft. Met `String[]::new` kun je het resultaat zonder cast toewijzen aan een variabele van het type `String[]`. `Arrays.toString` toont `[Ada, Clara]`.

Gerelateerde lessen

  • Java · Les 63 · Basis · Versie: 2

Bronnen