CKTIS / Java
Stream.toList: praktische referentie
Stream.toList: praktische referentie: Stream.toList() is sinds Java 16 een terminale bewerking die elementen in encounter order in een niet-wijzigbare List verzamelt.
Versie: Java SE 21 (JLS and Java SE API); examples verified on the repository Java runtime
Syntax
Stream.toList(...)Stream.toList() is sinds Java 16 een terminale bewerking die elementen in encounter order in een niet-wijzigbare List verzamelt.
Gebruik haar voor een resultaatmomentopname zonder latere wijzigingen; gebruik Collectors.toCollection voor een specifieke veranderlijke implementatie.
Elke mutator op het resultaat werpt UnsupportedOperationException; veronderstel geen implementatietype, serialiseerbaarheid of identiteit van de mogelijk value-based instantie.
Een lege stream geeft een lege lijst en null-elementen blijven behouden; het null-contract verschilt dus van Collectors.toUnmodifiableList.
toList behoudt het null-element, zodat de eerste regel [a, null] is; add werpt UnsupportedOperationException en de catch schrijft unmodifiable.
Voorbeelden
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"); }
}
}
Resultaat
[a, null] unmodifiable
toList behoudt het null-element, zodat de eerste regel [a, null] is; add werpt UnsupportedOperationException en de catch schrijft unmodifiable.