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.