CKTIS / Java
java.util.List — eine geordnete Sammlung von Elementen
List<E> beschreibt eine geordnete Sammlung mit nullbasierten Indizes, die normalerweise Duplikate zulässt. Erfahre, wie du Elemente liest, hinzufügst und entfernst und worin sich eine veränderbare Liste, eine unveränderbare Kopie und eine Bereichsansicht unterscheiden.
Version: 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> ist eine Schnittstelle für geordnete Sammlungen, die normalerweise Duplikate zulassen; E bezeichnet den Elementtyp. ArrayList ist eine veränderbare Implementierung. List.size() gibt die Anzahl der Elemente an, und List.isEmpty() prüft, ob die Liste leer ist. List.get(i) liest ein Element; gültige Indizes erfüllen 0 <= i < size().
List.add(e) hängt ein Element an, während List.add(i, e) es an Position i einfügt; auch i == size() ist zulässig. List.addAll(c) hängt Elemente in der Iterationsreihenfolge der Sammlung an; List.addAll(i, c) fügt sie an Position i ein. List.set(i, e) ersetzt ein Element und gibt dessen vorherigen Wert zurück, ohne die Größe zu ändern. List.clear() entfernt alle Elemente.
List.contains(o) prüft anhand der Gleichheit, ob ein Element enthalten ist, und List.indexOf(o) gibt den ersten Index oder -1 zurück. List.remove(i) entfernt das Element am Index und gibt es zurück; List.remove(o) entfernt das erste gleiche Vorkommen und gibt an, ob sich die Liste geändert hat. Bei List<Integer> entfernt remove(1) nach Index, während remove(Integer.valueOf(1)) nach Wert entfernt.
List.of(...) erstellt eine unveränderbare Liste; List.copyOf(c) liefert eine unveränderbare Momentaufnahme, die von späteren Änderungen an der Elementzugehörigkeit der Quellsammlung unberührt bleibt. Beide Fabrikmethoden lehnen null ab. Sie kopieren die Elemente nicht tief: enthaltene Objekte können weiterhin verändert werden. Änderungsoperationen sind in der Schnittstelle optional; Listen aus diesen Fabrikmethoden werfen bei einem Änderungsversuch UnsupportedOperationException.
List.subList(from, to) gibt eine Ansicht des Bereichs [from, to) zurück, keine unabhängige Kopie. Unterstützte Änderungen über die Ansicht wirken sich auf die zugrunde liegende Liste aus; subList(from, to).clear() entfernt den Bereich. Eine strukturelle Änderung der zugrunde liegenden Liste außerhalb der Ansicht macht die Semantik der Ansicht undefiniert. In Java 21 wirft ArrayList eine IndexOutOfBoundsException, wenn from < 0 oder to > size() gilt. Andernfalls wirft die Methode bei from > to eine IllegalArgumentException.
Beispiele
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());
}
}Ergebnis
5 A B true 1 A true [X] [X, C, D] true
Der angezeigte Code und das angegebene Ergebnis wurden in einer isolierten Umgebung mit der im Prüfnachweis für genau diese Version dokumentierten Methode verifiziert.