Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / Java

Stream.toList: riferimento pratico

Stream.toList: riferimento pratico: Stream.toList() è un’operazione terminale da Java 16 che accumula gli elementi secondo encounter order in una List non modificabile.

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

Sintassi

Stream.toList(...)

Stream.toList() è un’operazione terminale da Java 16 che accumula gli elementi secondo encounter order in una List non modificabile.

Usala per un’istantanea del risultato che non richiede modifiche; se serve un’implementazione mutabile precisa usa Collectors.toCollection.

Ogni mutator del risultato genera UnsupportedOperationException; non assumere tipo di implementazione, serializzabilità o identità dell’istanza forse value-based.

Uno stream vuoto produce una lista vuota e gli elementi null sono mantenuti; il contratto su null differisce quindi da Collectors.toUnmodifiableList.

toList mantiene l’elemento null, quindi la prima riga è [a, null]; add genera UnsupportedOperationException e il catch stampa unmodifiable.

Esempi

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"); }
    }
}

Risultato

[a, null]
unmodifiable

toList mantiene l’elemento null, quindi la prima riga è [a, null]; add genera UnsupportedOperationException e il catch stampa unmodifiable.

Fonti