CKTIS / Java
java.util.List — uspořádaná kolekce prvků
List<E> popisuje uspořádanou kolekci s indexy od nuly, která obvykle umožňuje duplicity. Naučte se číst, přidávat a odebírat prvky a rozlišovat mezi měnitelným seznamem, neměnitelnou kopií a pohledem na část seznamu.
Verze: Java SE 21; repository runtime, production runtime not attested
Syntaxe
List<E> list = new ArrayList<>();
List<E> values = List.of(e1, e2);
List<E> snapshot = List.copyOf(list);java.util.List<E> je rozhraní uspořádané kolekce, která obvykle umožňuje duplicity; E označuje typ prvku. ArrayList je měnitelná implementace. List.size() udává počet prvků a List.isEmpty() ověřuje, zda je seznam prázdný. List.get(i) načte prvek; platné indexy splňují 0 <= i < size().
List.add(e) připojí prvek na konec, zatímco List.add(i, e) jej vloží na pozici i; povoleno je také i == size(). List.addAll(c) připojí prvky v pořadí iterace kolekce; List.addAll(i, c) je vloží na určenou pozici. List.set(i, e) nahradí prvek a vrátí jeho předchozí hodnotu, aniž změní velikost. List.clear() odstraní všechny prvky.
List.contains(o) ověřuje přítomnost pomocí rovnosti a List.indexOf(o) vrátí první index nebo -1. List.remove(i) odstraní a vrátí prvek na daném indexu; List.remove(o) odstraní první stejný výskyt a oznámí, zda se seznam změnil. U List<Integer> odstraní remove(1) prvek podle indexu, zatímco remove(Integer.valueOf(1)) podle hodnoty.
List.of(...) vytvoří neměnitelný seznam; List.copyOf(c) poskytne neměnitelný snímek, jehož složení se nezmění, ani když se později změní složení zdrojové kolekce. Obě tovární metody odmítají null. Prvky nekopírují do hloubky: obsažené objekty se stále mohou měnit. Měnicí operace jsou v rozhraní volitelné; seznamy vytvořené těmito továrními metodami při pokusu o změnu vyvolají UnsupportedOperationException.
List.subList(from, to) vrací pohled na [from, to), nikoli nezávislou kopii. Podporované změny provedené přes pohled ovlivňují podkladový seznam; subList(from, to).clear() odstraní daný rozsah. Strukturální změna podkladového seznamu mimo pohled způsobí, že sémantika pohledu není definována. V Javě 21 vyvolá metoda v ArrayList výjimku IndexOutOfBoundsException, pokud platí from < 0 nebo to > size(). V opačném případě vyvolá při from > to výjimku IllegalArgumentException.
Pří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ýsledek
5 A B true 1 A true [X] [X, C, D] true
Zobrazený kód a uvedený výsledek byly ověřeny v izolovaném prostředí metodou zaznamenanou v dokladu o ověření této přesné verze.