KennisbankExamencentrum
NL · NLNederlands (Nederland)
Taal kiezen13

CKTIS / Java

List.add(E) — een element achteraan een lijst toevoegen

`List.add(E)` voegt één element toe aan het einde van de bestaande lijst en retourneert `true` als de aanroep normaal eindigt. Niet elke lijst ondersteunt toevoegen.

Versie: Java SE 21

Syntax

boolean add(E e)

boolean added = items.add(element);

List.add(E) is de methode met één argument op java.util.List<E>. E is het elementtype, bijvoorbeeld Customer in een repository die een List<Customer> gebruikt. De methode wijzigt de bestaande lijst: het nieuwe element komt achteraan en de eerdere elementen behouden hun volgorde. Als de aanroep normaal eindigt, krijg je true terug, geen index of nieuwe lijst.

De lijst bewaart de referentie die je doorgeeft, geen kopie van het object. Een ArrayList kan dezelfde referentie meermaals bewaren; wijzigingen aan het gedeelde object zijn zichtbaar via elke positie die ernaar verwijst. Lijsten staan doorgaans duplicaten toe. Met opeenvolgende add-aanroepen kun je dus gebeurtenissen of ontvangers vastleggen in de volgorde waarin je ze toevoegt.

Achteraan toevoegen is optioneel: een lijst uit List.of(...) kan niet worden gewijzigd en gooit UnsupportedOperationException. Een lijst die toevoegen ondersteunt, kan een element toch weigeren: NullPointerException als null niet is toegestaan, ClassCastException als de klasse van het element niet is toegestaan of IllegalArgumentException als een andere eigenschap van het element niet is toegestaan. ArrayList staat null toe.

De overload add(int index, E element) retourneert void en voegt in op een index van 0 tot en met size(). Elementen vanaf die positie schuiven op. Wil je een verwijdering ongedaan maken en de oorspronkelijke positie herstellen, gebruik dan de opgeslagen index; add(element) voegt alleen achteraan toe. Sinds Java 21 voegt ook addLast(E) achteraan toe, maar die methode retourneert void.

Voorbeelden

import java.util.ArrayList;
import java.util.List;

public class Main {
    public static void main(String[] args) {
        List<StringBuilder> items = new ArrayList<>();
        StringBuilder first = new StringBuilder("Ada");

        boolean added = items.add(first);
        items.add(new StringBuilder("Lin"));
        items.add(first);

        System.out.println(added);
        System.out.println(items);
        System.out.println(items.get(0) == items.get(2));
        first.append("!");
        System.out.println(items);
    }
}

Resultaat

true
[Ada, Lin, Ada]
true
[Ada!, Lin, Ada!]

De eerste `true` is het resultaat van `add`; de tweede is het resultaat van het vergelijken van referenties met `==`. Na de wijziging van `first` tonen beide posities `Ada!`, omdat ze naar hetzelfde object verwijzen.

Gerelateerde lessen

  • Java · Les 21 · Gemiddeld · Versie: 2
  • Java · Les 22 · Gemiddeld · Versie: 2
  • Java · Les 26 · Gemiddeld · Versie: 2
  • Java · Les 27 · Gemiddeld · Versie: 2
  • Java · Les 32 · Gemiddeld · Versie: 2

Bronnen