Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

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.

Źródła