Base de connaissancesCentre d’examen
FRFrançais
Choisir la langue13

CKTIS / Java

Convertir un flux en tableau typé avec Stream.toArray(IntFunction)

Rassemblez les éléments d’un flux dans un tableau du type choisi, par exemple `String[]`, en fournissant une fonction qui crée un tableau de la longueur demandée.

Version : Java SE 21

Syntaxe

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

En Java SE 21, Stream.toArray(IntFunction), définie dans java.util.stream.Stream<T>, rassemble les éléments produits par la chaîne d’opérations dans un tableau A[]. C’est une opération terminale : vous ne pouvez pas réutiliser le même flux ensuite. Si le flux a un ordre de parcours défini, le tableau le conserve.

Le générateur java.util.function.IntFunction<A[]> reçoit une longueur de type int et renvoie un nouveau tableau de cette longueur. Ici, String[]::new équivaut à length -> new String[length]. Le flux fournit la taille : ne supposez pas qu’il appelle le générateur une seule fois. Des tableaux supplémentaires peuvent être nécessaires pour diviser le traitement en plusieurs parties ou pour redimensionner un tableau.

Sans argument, toArray() renvoie un Object[] dont le type de composant à l’exécution est Object, même pour un Stream<String>. Dans la surcharge avec générateur, A est le type de composant du tableau, indépendant du type T des éléments du flux. La méthode ne convertit pas les éléments : elle lève une ArrayStoreException si le type de composant à l’exécution empêche d’y stocker un élément.

Exemples

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

Résultat

[Ada, Clara]

`filter` écarte `Bo` car ce nom compte moins de 3 caractères. `String[]::new` permet d’affecter le résultat à une variable de type `String[]` sans conversion explicite de type, et `Arrays.toString` affiche `[Ada, Clara]`.

Leçons associées

  • Java · Leçon 63 · Débutant · Version : 2

Sources