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

CKTIS / Java

Stream.flatMap: référence pratique

Stream.flatMap: référence pratique: flatMap est une opération intermédiaire un-vers-plusieurs qui remplace chaque élément par le contenu d’un stream produit par le mapper puis aplatit les résultats.

Version : Java SE 21 (JLS and Java SE API); examples verified on the repository Java runtime

Syntaxe

Stream.flatMap(...)

flatMap est une opération intermédiaire un-vers-plusieurs qui remplace chaque élément par le contenu d’un stream produit par le mapper puis aplatit les résultats.

Utilise-la pour développer des collections imbriquées, des lignes en mots ou des relations parent-enfants donnant zéro à plusieurs résultats.

Le mapper doit être stateless et non-interfering ; chaque stream produit est fermé après consommation de son contenu et ne doit plus être réutilisé.

Un stream null rendu par le mapper est traité comme vide ; les éléments null d’un sous-stream peuvent continuer et une source ordonnée conserve son ordre.

L’exemple exerce l’élément documenté dans un petit programme déterministe et compare exactement la sortie standard.

Exemples

public class Main {
    public static void main(String[] args) throws Exception {
        var result = java.util.stream.Stream.of(java.util.List.of(1, 2), java.util.List.of(3)).flatMap(java.util.Collection::stream).toList();
        System.out.println(result);
    }
}

Résultat

[1, 2, 3]

L’exemple exerce l’élément documenté dans un petit programme déterministe et compare exactement la sortie standard.

Sources