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

CKTIS / Java

Arrays.stream(T[]) : créer un flux à partir d’un tableau

Utilisez un tableau d’éléments de type référence comme source d’un flux séquentiel, filtrez ses éléments et placez le résultat dans un tableau du type voulu.

Version : Java SE 21

Syntaxe

public static <T> Stream<T> stream(T[] array)

Arrays.stream(T[]) est une méthode statique de java.util.Arrays, disponible depuis Java 8. Elle utilise un tableau d’éléments de type référence comme source d’un flux séquentiel java.util.stream.Stream<T> dans l’ordre des indices. Par exemple, un String[] donne un Stream<String>. La méthode ne copie pas le tableau source ; passer une référence de tableau null déclenche une NullPointerException.

Les opérations intermédiaires comme filter sont paresseuses : le traitement commence à l’appel d’une opération terminale comme toArray(). Ne modifiez pas le tableau source pendant le traitement. Ne réutilisez pas le même flux après une opération terminale. Pour traiter de nouveau le tableau, créez un nouveau flux.

La surcharge avec bornes, Arrays.stream(array, startInclusive, endExclusive), inclut l’indice de début et exclut l’indice de fin. Elle exige 0 <= startInclusive <= endExclusive <= array.length ; des bornes invalides déclenchent une ArrayIndexOutOfBoundsException. Les surcharges pour int[], long[] et double[] renvoient respectivement IntStream, LongStream et DoubleStream. Il n’existe pas de surcharge directe pour les autres tableaux unidimensionnels de type primitif, comme boolean[].

Sur un Stream<T>, la méthode sans argument toArray() a pour type de retour déclaré Object[], mais Java SE 21 ne spécifie pas la classe exacte du tableau renvoyé à l’exécution. Ne convertissez pas ce résultat en String[] par un transtypage. Si vous avez besoin d’un String[], utilisez toArray(String[]::new) sur un flux de chaînes.

Avec l’API de réflexion, vous pouvez passer l’Object[] obtenu à Constructor.newInstance(Object...). Ses éléments deviennent les arguments successifs du constructeur choisi. Leur nombre, leur ordre et leurs types doivent correspondre aux paramètres du constructeur, compte tenu des conversions autorisées. Un nombre d’arguments incorrect ou un type incompatible déclenche une IllegalArgumentException.

Exemples

import java.util.Arrays;

public class Main {
    public record Pair(String first, String second) {}

    public static void main(String[] args) throws ReflectiveOperationException {
        String[] input = {"Ada", " ", "Lin"};
        Object[] arguments = Arrays.stream(input)
                .filter(name -> !name.isBlank())
                .toArray();

        Pair pair = Pair.class.getConstructor(String.class, String.class)
                .newInstance(arguments);

        System.out.println(Arrays.toString(arguments));
        System.out.println(pair.first() + " / " + pair.second());
    }
}

Résultat

[Ada, Lin]
Ada / Lin

`filter` écarte la chaîne qui ne contient qu’une espace. `toArray()` place `Ada` et `Lin` dans un `Object[]` dans cet ordre, puis `newInstance` les passe comme deux arguments au constructeur de `Pair`.

Leçons associées

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

Sources