Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / Java

Stream.flatMap: praktyczna referencja

Stream.flatMap: praktyczna referencja: flatMap jest operacją pośrednią one-to-many, która zastępuje każdy element zawartością stream zwróconego przez mapper i spłaszcza wyniki.

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

Składnia

Stream.flatMap(...)

flatMap jest operacją pośrednią one-to-many, która zastępuje każdy element zawartością stream zwróconego przez mapper i spłaszcza wyniki.

Stosuj ją do rozwijania zagnieżdżonych kolekcji, linii na słowa lub relacji rodzic–dzieci, gdy każdy element tworzy zero albo wiele wyników.

Mapper musi być stateless i non-interfering; każdy utworzony stream jest zamykany po skopiowaniu jego zawartości, więc nie wolno go później ponownie używać.

Wynik mappera null jest traktowany jak pusty stream; elementy null wewnątrz strumienia podrzędnego mogą przepłynąć, a encounter order jest zachowany dla źródła uporządkowanego.

Przykład sprawdza opisywany element w małym, deterministycznym programie i porównuje dokładny standardowy wynik.

Przykłady

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

Wynik

[1, 2, 3]

Przykład sprawdza opisywany element w małym, deterministycznym programie i porównuje dokładny standardowy wynik.

Źródła