WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / Java

Stream.flatMap: praktische Referenz

Stream.flatMap: praktische Referenz: flatMap ist eine One-to-many-Zwischenoperation, die jedes Element durch den Inhalt eines vom Mapper erzeugten Streams ersetzt und die Ergebnisse abflacht.

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

Syntax

Stream.flatMap(...)

flatMap ist eine One-to-many-Zwischenoperation, die jedes Element durch den Inhalt eines vom Mapper erzeugten Streams ersetzt und die Ergebnisse abflacht.

Nutze sie zum Entfalten verschachtelter Sammlungen, von Zeilen in Wörter oder Eltern-Kind-Beziehungen mit null bis vielen Ausgaben je Quellelement.

Der Mapper muss stateless und non-interfering sein; jeder erzeugte Stream wird nach Verbrauch seines Inhalts geschlossen und darf danach nicht wiederverwendet werden.

Ein vom Mapper geliefertes null wird als leerer Stream behandelt; null-Elemente im Teilstream dürfen weiterfließen und geordnete Quellen behalten ihre Reihenfolge.

Das Beispiel prüft das dokumentierte Element in einem kleinen deterministischen Programm und vergleicht die exakte Standardausgabe.

Beispiele

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

Ergebnis

[1, 2, 3]

Das Beispiel prüft das dokumentierte Element in einem kleinen deterministischen Programm und vergleicht die exakte Standardausgabe.

Quellen