CKTIS / Java
java.util.List — uporządkowana kolekcja elementów
List<E> opisuje uporządkowaną kolekcję z indeksami od zera, zwykle dopuszczającą duplikaty. Poznaj odczyt, dodawanie i usuwanie elementów oraz różnicę między modyfikowalną listą, niemodyfikowalną kopią i widokiem fragmentu.
Wersja: Java SE 21; repository runtime, production runtime not attested
Składnia
List<E> list = new ArrayList<>();
List<E> values = List.of(e1, e2);
List<E> snapshot = List.copyOf(list);java.util.List<E> to interfejs uporządkowanej kolekcji, zwykle dopuszczającej duplikaty; E oznacza typ elementu. ArrayList jest modyfikowalną implementacją. List.size() podaje liczbę elementów, a List.isEmpty() sprawdza, czy lista jest pusta. List.get(i) odczytuje element; poprawne indeksy to 0 <= i < size().
List.add(e) dopisuje element, a List.add(i, e) wstawia go na pozycji i, dopuszczając także i == size(). List.addAll(c) dopisuje elementy w kolejności iteracji kolekcji; wariant List.addAll(i, c) je wstawia. List.set(i, e) zastępuje element i zwraca poprzedni, bez zmiany rozmiaru. List.clear() usuwa wszystkie elementy.
List.contains(o) sprawdza obecność według równości, a List.indexOf(o) zwraca pierwszy indeks lub -1. List.remove(i) usuwa i zwraca element pod indeksem; List.remove(o) usuwa pierwsze równe wystąpienie i zwraca informację o zmianie. Dla List<Integer> wywołanie remove(1) usuwa według indeksu, a remove(Integer.valueOf(1)) według wartości.
List.of(...) tworzy listę niemodyfikowalną; List.copyOf(c) daje niemodyfikowalny obraz kolekcji, niezależny od późniejszych zmian jej składu. Obie fabryki odrzucają null. Nie kopiują głęboko elementów: obiekty w środku nadal mogą się zmieniać. Operacje modyfikujące są opcjonalne w interfejsie; listy z tych fabryk zgłaszają UnsupportedOperationException przy próbie modyfikacji.
List.subList(from, to) zwraca widok zakresu [from, to), nie niezależną kopię. Obsługiwane zmiany widoku wpływają na listę bazową; subList(from, to).clear() usuwa zakres. Zmiana strukturalna listy bazowej poza widokiem powoduje, że semantyka widoku staje się niezdefiniowana. W ArrayList w Javie 21 metoda zgłasza IndexOutOfBoundsException, jeśli from < 0 lub to > size(). W przeciwnym razie, jeśli from > to, zgłasza IllegalArgumentException.
Przykłady
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());
}
}Wynik
5 A B true 1 A true [X] [X, C, D] true
Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.