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

CKTIS / Java

Stream.toList: referência prática

Stream.toList: referência prática: Stream.toList() é uma operação terminal desde Java 16 que acumula elementos segundo encounter order numa List não modificável.

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

Sintaxe

Stream.toList(...)

Stream.toList() é uma operação terminal desde Java 16 que acumula elementos segundo encounter order numa List não modificável.

Usa-a para um instantâneo do resultado sem alterações posteriores; para uma implementação mutável específica usa Collectors.toCollection.

Qualquer método mutador lança UnsupportedOperationException; não pressuponhas tipo de implementação, serialização nem identidade da possível instância value-based.

Um stream vazio produz uma lista vazia e os elementos null são mantidos; o contrato de null difere assim de Collectors.toUnmodifiableList.

toList mantém o elemento null, portanto a primeira linha é [a, null]; add lança UnsupportedOperationException e o catch escreve unmodifiable.

Exemplos

public class Main {
    public static void main(String[] args) throws Exception {
        var result = java.util.stream.Stream.of("a", null).toList();
        System.out.println(result);
        try { result.add("b"); } catch (UnsupportedOperationException error) { System.out.println("unmodifiable"); }
    }
}

Resultado

[a, null]
unmodifiable

toList mantém o elemento null, portanto a primeira linha é [a, null]; add lança UnsupportedOperationException e o catch escreve unmodifiable.

Fontes