CKTIS / Java
java.util.List — uređena kolekcija elemenata
List<E> opisuje uređenu kolekciju s indeksima koji počinju od nule i koja obično dopušta duplikate. Nauči čitati, dodavati i uklanjati elemente te razlikovati promjenjivu listu, nepromjenjivu kopiju i pogled na raspon.
Verzija: Java SE 21; repository runtime, production runtime not attested
Sintaksa
List<E> list = new ArrayList<>();
List<E> values = List.of(e1, e2);
List<E> snapshot = List.copyOf(list);java.util.List<E> sučelje je uređene kolekcije koja obično dopušta duplikate; E označava tip elementa. ArrayList je promjenjiva implementacija. List.size() daje broj elemenata, a List.isEmpty() provjerava je li lista prazna. List.get(i) čita element; valjani indeksi zadovoljavaju 0 <= i < size().
List.add(e) dodaje element na kraj, dok ga List.add(i, e) umeće na poziciju i; dopušteno je i i == size(). List.addAll(c) dodaje elemente prema redoslijedu iteracije kolekcije; List.addAll(i, c) umeće ih na zadanu poziciju. List.set(i, e) zamjenjuje element i vraća njegovu prethodnu vrijednost bez promjene veličine. List.clear() uklanja sve elemente.
List.contains(o) provjerava prisutnost prema jednakosti, a List.indexOf(o) vraća prvi indeks ili -1. List.remove(i) uklanja i vraća element na indeksu; List.remove(o) uklanja prvo jednako pojavljivanje i javlja je li se lista promijenila. Za List<Integer>, remove(1) uklanja prema indeksu, dok remove(Integer.valueOf(1)) uklanja prema vrijednosti.
List.of(...) stvara nepromjenjivu listu; List.copyOf(c) daje nepromjenjiv snimak na koji ne utječu kasnije promjene članstva izvorne kolekcije. Obje tvorničke metode odbijaju null. Ne kopiraju elemente dubinski: sadržani objekti i dalje se mogu mijenjati. Operacije mijenjanja neobavezne su u sučelju; liste dobivene ovim tvorničkim metodama pri pokušaju izmjene izbacuju UnsupportedOperationException.
List.subList(from, to) vraća pogled na [from, to), a ne neovisnu kopiju. Podržane promjene putem pogleda utječu na osnovnu listu; subList(from, to).clear() uklanja raspon. Strukturna promjena osnovne liste izvan pogleda čini semantiku pogleda nedefiniranom. U Javi 21 metoda u klasi ArrayList baca iznimku IndexOutOfBoundsException ako vrijedi from < 0 ili to > size(). U suprotnom, ako vrijedi from > to, baca iznimku IllegalArgumentException.
Primjeri
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());
}
}Rezultat
5 A B true 1 A true [X] [X, C, D] true
Prikazani kôd i navedeni rezultat provjereni su u izoliranom okruženju metodom zabilježenom u dokazu provjere za ovu točnu verziju.