KennisbankExamencentrum
NL · NLNederlands (Nederland)
Taal kiezen13

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.

Bronnen