База знанияИзпитен център
BGБългарски
Избери език13

CKTIS / Java

Stream.toList: практическа справка

Stream.toList: практическа справка: Stream.toList() е крайна операция от Java 16, която събира елементите според encounter order в непроменяем List.

Версия: Java SE 21 (JLS and Java SE API); examples verified on the repository Java runtime

Синтаксис

Stream.toList(...)

Stream.toList() е крайна операция от Java 16, която събира елементите според encounter order в непроменяем List.

Използвай я за моментна снимка на резултата без последващи промени; за конкретна изменяема реализация използвай Collectors.toCollection.

Всеки mutator на резултата хвърля UnsupportedOperationException; не предполагай тип на реализация, сериализируемост или идентичност на възможната value-based инстанция.

Празен stream дава празен списък и елементите null се запазват; договорът за null се различава от Collectors.toUnmodifiableList.

toList запазва елемента null, затова първият ред е [a, null]; add хвърля UnsupportedOperationException, а catch извежда unmodifiable.

Примери

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

Резултат

[a, null]
unmodifiable

toList запазва елемента null, затова първият ред е [a, null]; add хвърля UnsupportedOperationException, а catch извежда unmodifiable.

Източници