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.