KennisbankExamencentrum
NL · NLNederlands (Nederland)
Taal kiezen13

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.

Bronnen