Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

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.

Fontes