CKTIS / Java
Stream.mapMulti: referência prática
Stream.mapMulti: referência prática: mapMulti é uma operação intermédia um-para-zero-ou-muitos cujo mapper envia resultados para um Consumer em vez de criar um stream separado.
Versão: Java SE 21 (JLS and Java SE API); examples verified on the repository Java runtime
Sintaxe
Stream.mapMulti(...)mapMulti é uma operação intermédia um-para-zero-ou-muitos cujo mapper envia resultados para um Consumer em vez de criar um stream separado.
Usa-a para poucas saídas por entrada ou expansão imperativa, evitando os streams filhos exigidos por flatMap.
O Consumer fornecido ao mapper só pode ser usado durante essa chamada; guardá-lo e invocá-lo depois produz resultados indefinidos.
O mapper pode não chamar o Consumer; a inferência por vezes exige explícito e a ordem das chamadas determina a saída numa fonte ordenada.
O exemplo exercita o elemento documentado num programa pequeno e determinístico e compara exatamente a saída padrão.
Exemplos
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]
O exemplo exercita o elemento documentado num programa pequeno e determinístico e compara exatamente a saída padrão.