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.