CKTIS / Java
Stream.mapMulti: praktische Referenz
Stream.mapMulti: praktische Referenz: mapMulti ist eine One-to-zero-or-many-Zwischenoperation, deren Mapper Ergebnisse an einen Consumer sendet, statt einen eigenen Stream zu erzeugen.
Version: Java SE 21 (JLS and Java SE API); examples verified on the repository Java runtime
Syntax
Stream.mapMulti(...)mapMulti ist eine One-to-zero-or-many-Zwischenoperation, deren Mapper Ergebnisse an einen Consumer sendet, statt einen eigenen Stream zu erzeugen.
Nutze sie für wenige Ausgaben je Eingabe oder imperatives Entfalten, um die von flatMap benötigten Teilstreams zu vermeiden.
Der an den Mapper übergebene Consumer darf nur während dieses Mapper-Aufrufs verwendet werden; Speichern und späteres Aufrufen hat undefinierte Ergebnisse.
Der Mapper darf den Consumer keinmal aufrufen; Typinferenz braucht manchmal ein explizites , und die Aufrufreihenfolge bestimmt bei geordneter Quelle die Ausgabe.
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(1, 3).<Integer>mapMulti((n, out) -> { for (int i = 0; i < n; i++) out.accept(n); }).toList();
System.out.println(result);
}
}
Ergebnis
[1, 3, 3, 3]
Das Beispiel prüft das dokumentierte Element in einem kleinen deterministischen Programm und vergleicht die exakte Standardausgabe.