CKTIS / Java
Stream.mapMulti: referencia práctica
Stream.mapMulti: referencia práctica: mapMulti es una operación intermedia uno-a-cero-o-muchos cuyo mapper envía resultados a un Consumer en lugar de crear un stream separado.
Versión: Java SE 21 (JLS and Java SE API); examples verified on the repository Java runtime
Sintaxis
Stream.mapMulti(...)mapMulti es una operación intermedia uno-a-cero-o-muchos cuyo mapper envía resultados a un Consumer en lugar de crear un stream separado.
Úsala para pocas salidas por entrada o expansión imperativa, evitando los streams secundarios que requiere flatMap.
El Consumer entregado al mapper solo puede usarse durante esa llamada; conservarlo e invocarlo después produce resultados indefinidos.
El mapper puede no llamar al Consumer; la inferencia a veces necesita un explícito y el orden de llamadas fija los resultados en una fuente ordenada.
El ejemplo ejercita el elemento documentado en un programa pequeño y determinista y compara exactamente la salida estándar.
Ejemplos
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);
}
}
Resultado
[1, 3, 3, 3]
El ejemplo ejercita el elemento documentado en un programa pequeño y determinista y compara exactamente la salida estándar.