CKTIS / Java
java.util.List — usporiadaná kolekcia prvkov
List<E> opisuje usporiadanú kolekciu s indexmi od nuly, ktorá zvyčajne umožňuje duplicity. Naučte sa čítať, pridávať a odstraňovať prvky a rozlišovať medzi meniteľným zoznamom, nemeniteľnou kópiou a pohľadom na rozsah.
Verzia: Java SE 21; repository runtime, production runtime not attested
Syntax
List<E> list = new ArrayList<>();
List<E> values = List.of(e1, e2);
List<E> snapshot = List.copyOf(list);java.util.List<E> je rozhranie usporiadanej kolekcie, ktorá zvyčajne umožňuje duplicity; E označuje typ prvku. ArrayList je meniteľná implementácia. List.size() uvádza počet prvkov a List.isEmpty() kontroluje, či je zoznam prázdny. List.get(i) načíta prvok; platné indexy spĺňajú 0 <= i < size().
List.add(e) pridá prvok na koniec, kým List.add(i, e) ho vloží na pozíciu i; povolené je aj i == size(). List.addAll(c) pridá prvky v poradí iterácie kolekcie; List.addAll(i, c) ich vloží na určenú pozíciu. List.set(i, e) nahradí prvok a vráti jeho predchádzajúcu hodnotu bez zmeny veľkosti. List.clear() odstráni všetky prvky.
List.contains(o) kontroluje prítomnosť podľa rovnosti a List.indexOf(o) vráti prvý index alebo -1. List.remove(i) odstráni a vráti prvok na danom indexe; List.remove(o) odstráni prvý rovnaký výskyt a oznámi, či sa zoznam zmenil. Pri List<Integer> odstráni remove(1) prvok podľa indexu, zatiaľ čo remove(Integer.valueOf(1)) ho odstráni podľa hodnoty.
List.of(...) vytvorí nemeniteľný zoznam; List.copyOf(c) poskytne nemeniteľný snímok, ktorý neovplyvnia neskoršie zmeny členstva v zdrojovej kolekcii. Obe továrenské metódy odmietajú null. Prvky nekopírujú do hĺbky: obsiahnuté objekty sa môžu naďalej meniť. Operácie meniace obsah sú v rozhraní voliteľné; zoznamy vytvorené týmito továrenskými metódami pri pokuse o zmenu vyvolajú UnsupportedOperationException.
List.subList(from, to) vracia pohľad na [from, to), nie nezávislú kópiu. Podporované zmeny cez pohľad ovplyvňujú podkladový zoznam; subList(from, to).clear() odstráni daný rozsah. Štrukturálna zmena podkladového zoznamu mimo pohľadu spôsobí, že sémantika pohľadu nie je definovaná. V Jave 21 vyvolá metóda v ArrayList výnimku IndexOutOfBoundsException, ak platí from < 0 alebo to > size(). V opačnom prípade vyvolá pri from > to výnimku IllegalArgumentException.
Príklady
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());
}
}Výsledok
5 A B true 1 A true [X] [X, C, D] true
Zobrazený kód a uvedený výsledok boli overené v izolovanom prostredí metódou zaznamenanou v dôkaze o overení tejto presnej verzie.