Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

CKTIS / Java

Stream.toList: praktická reference

Stream.toList: praktická reference: Stream.toList() je od Java 16 terminální operace, která shromáždí prvky podle encounter order do neměnitelné List.

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

Syntaxe

Stream.toList(...)

Stream.toList() je od Java 16 terminální operace, která shromáždí prvky podle encounter order do neměnitelné List.

Použij ji pro snímek výsledku bez pozdějších změn; pro konkrétní měnitelnou implementaci použij Collectors.toCollection.

Každý mutátor výsledku vyhodí UnsupportedOperationException; nepředpokládej typ implementace, serializovatelnost ani identitu případné value-based instance.

Prázdný stream dá prázdný seznam a prvky null zůstanou zachovány; kontrakt null se proto liší od Collectors.toUnmodifiableList.

toList zachová prvek null, takže první řádek je [a, null]; add vyhodí UnsupportedOperationException a catch vypíše unmodifiable.

Příklady

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

Výsledek

[a, null]
unmodifiable

toList zachová prvek null, takže první řádek je [a, null]; add vyhodí UnsupportedOperationException a catch vypíše unmodifiable.

Zdroje