Base de connaissancesCentre d’examen
FRFrançais
Choisir la langue13

CKTIS / Java

Stream.toList: référence pratique

Stream.toList: référence pratique: Stream.toList() est une opération terminale disponible depuis Java 16 qui accumule les éléments selon encounter order dans une List non modifiable.

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

Syntaxe

Stream.toList(...)

Stream.toList() est une opération terminale disponible depuis Java 16 qui accumule les éléments selon encounter order dans une List non modifiable.

Utilise-la pour un instantané du résultat sans modification ultérieure ; pour une implémentation mutable précise, utilise Collectors.toCollection.

Tout mutateur du résultat lève UnsupportedOperationException ; ne suppose ni type d’implémentation, ni sérialisation, ni identité de cette instance potentiellement value-based.

Un stream vide donne une liste vide et les éléments null sont conservés ; son contrat sur null diffère donc de Collectors.toUnmodifiableList.

toList conserve l’élément null, donc la première ligne vaut [a, null] ; add lève UnsupportedOperationException et le catch affiche unmodifiable.

Exemples

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

Résultat

[a, null]
unmodifiable

toList conserve l’élément null, donc la première ligne vaut [a, null] ; add lève UnsupportedOperationException et le catch affiche unmodifiable.

Sources