CKTIS / Java
java.util.List — een geordende verzameling elementen
List<E> beschrijft een geordende verzameling met indexen vanaf nul, waarin meestal duplicaten zijn toegestaan. Leer elementen lezen, toevoegen en verwijderen, en het verschil tussen een wijzigbare lijst, een niet-wijzigbare kopie en een bereikweergave.
Versie: 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> is een interface voor geordende verzamelingen waarin meestal duplicaten zijn toegestaan; E staat voor het elementtype. ArrayList is een wijzigbare implementatie. List.size() geeft het aantal elementen en List.isEmpty() controleert of de lijst leeg is. List.get(i) leest een element; geldige indexen voldoen aan 0 <= i < size().
List.add(e) voegt een element achteraan toe, terwijl List.add(i, e) het invoegt op positie i; ook i == size() is toegestaan. List.addAll(c) voegt elementen toe in de iteratievolgorde van de verzameling; List.addAll(i, c) voegt ze in op de opgegeven positie. List.set(i, e) vervangt een element en geeft de vorige waarde terug zonder de grootte te wijzigen. List.clear() verwijdert alle elementen.
List.contains(o) controleert op aanwezigheid op basis van gelijkheid, en List.indexOf(o) geeft de eerste index of -1 terug. List.remove(i) verwijdert het element op de index en geeft het terug; List.remove(o) verwijdert de eerste gelijke waarde en meldt of de lijst is gewijzigd. Bij List<Integer> verwijdert remove(1) op basis van de index, terwijl remove(Integer.valueOf(1)) op basis van de waarde verwijdert.
List.of(...) maakt een niet-wijzigbare lijst; List.copyOf(c) levert een niet-wijzigbare momentopname die niet verandert als er later elementen aan de bronverzameling worden toegevoegd of als er elementen uit die verzameling worden verwijderd of vervangen. Beide fabrieksmethoden weigeren null. Ze maken geen diepe kopie van elementen: objecten in de lijst kunnen nog steeds veranderen. Wijzigingsbewerkingen zijn optioneel in de interface; lijsten van deze fabrieksmethoden gooien UnsupportedOperationException bij een poging tot wijzigen.
List.subList(from, to) geeft een weergave van [from, to) terug, geen onafhankelijke kopie. Ondersteunde wijzigingen via de weergave beïnvloeden de onderliggende lijst; subList(from, to).clear() verwijdert het bereik. Een structurele wijziging van de onderliggende lijst buiten de weergave maakt de semantiek van de weergave ongedefinieerd. In Java 21 gooit ArrayList een IndexOutOfBoundsException als from < 0 of to > size(). Zo niet, dan gooit de methode een IllegalArgumentException als from > to.
Voorbeelden
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());
}
}Resultaat
5 A B true 1 A true [X] [X, C, D] true
De getoonde code en het opgegeven resultaat zijn in een geïsoleerde omgeving geverifieerd met de methode die in het verificatiebewijs voor exact deze versie is vastgelegd.