CKTIS / Java
java.util.List — подредена колекция от елементи
List<E> описва подредена колекция с индекси, започващи от нула, която обикновено допуска дубликати. Научете как да четете, добавяте и премахвате елементи и как да различавате променяем списък, непроменяемо копие и изглед на диапазон.
Версия: Java SE 21; repository runtime, production runtime not attested
Синтаксис
List<E> list = new ArrayList<>();
List<E> values = List.of(e1, e2);
List<E> snapshot = List.copyOf(list);java.util.List<E> е интерфейс за подредена колекция, която обикновено допуска дубликати; E обозначава типа на елемента. ArrayList е променяема реализация. List.size() показва броя на елементите, а List.isEmpty() проверява дали списъкът е празен. List.get(i) прочита елемент; валидните индекси отговарят на 0 <= i < size().
List.add(e) добавя елемент в края, а List.add(i, e) го вмъква на позиция i; допустимо е и i == size(). List.addAll(c) добавя елементите в реда на обхождане на колекцията; List.addAll(i, c) ги вмъква на посочената позиция. List.set(i, e) заменя елемент и връща предишната му стойност, без да променя размера. List.clear() премахва всички елементи.
List.contains(o) проверява наличието според равенството, а List.indexOf(o) връща първия индекс или -1. List.remove(i) премахва и връща елемента на съответния индекс; List.remove(o) премахва първото равно срещане и показва дали списъкът се е променил. При List<Integer> remove(1) премахва по индекс, докато remove(Integer.valueOf(1)) премахва по стойност.
List.of(...) създава непроменяем списък; List.copyOf(c) предоставя непроменяем моментен образ, който не се влияе от последващи промени в състава на изходната колекция. И двете фабрични операции отхвърлят null. Те не копират елементите в дълбочина: съдържащите се обекти все още могат да се променят. Операциите за промяна са незадължителни в интерфейса; списъците, създадени от тези фабрични операции, хвърлят UnsupportedOperationException при опит за промяна.
List.subList(from, to) връща изглед на [from, to), а не независимо копие. Поддържаните промени чрез изгледа засягат основния списък; subList(from, to).clear() премахва диапазона. Структурна промяна на основния списък извън изгледа прави семантиката на изгледа неопределена. В Java 21 методът в ArrayList хвърля IndexOutOfBoundsException, ако from < 0 или to > size(). В противен случай, ако from > to, хвърля IllegalArgumentException.
Примери
import java.util.ArrayList;
import java.util.List;
public class Main {
public static void main(String[] args) {
List<String> items = new ArrayList<>(List.of("A", "B"));
items.add("C");
items.addAll(List.of("D", "E"));
System.out.println(items.size() + " " + items.get(0));
System.out.println(items.set(1, "X"));
System.out.println(items.contains("X") + " " + items.indexOf("X"));
System.out.println(items.remove(0));
System.out.println(items.remove("E"));
List<String> snapshot = List.copyOf(items);
items.subList(1, 3).clear();
System.out.println(items);
System.out.println(snapshot);
items.clear();
System.out.println(items.isEmpty());
}
}Резултат
5 A B true 1 A true [X] [X, C, D] true
Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.