KennisbankExamencentrum
NL · NLNederlands (Nederland)
Taal kiezen13

CKTIS / Java

List.addAll — elementen achteraan toevoegen of invoegen

Gebruik `List.addAll` om de elementen van een collectie achteraan een lijst toe te voegen of ze op een gekozen index in te voegen. De `boolean`-waarde geeft aan of de doellijst is gewijzigd.

Versie: Java SE 21

Syntax

boolean addAll(Collection<? extends E> c)
boolean addAll(int index, Collection<? extends E> c)

In Java SE 21 heeft de interface java.util.List<E> twee overloads van List.addAll. List.addAll(Collection) voegt elementen achteraan de doellijst toe, in de volgorde waarin de iterator van de broncollectie ze oplevert. Is de bron een andere lijst, dan komen de elementen daarvan in hun oorspronkelijke volgorde achter de bestaande elementen van de doellijst. De methode sorteert niet en verwijdert geen duplicaten. Collection<? extends E> betekent dat de bron geen lijst hoeft te zijn en dat het gedeclareerde elementtype E of een subtype van E mag zijn.

List.addAll(int, Collection) voegt de elementen vanaf een index die bij nul begint in, in dezelfde volgorde als in de bron. Bestaande elementen vanaf de invoegpositie schuiven naar rechts. Geldige indices lopen van 0 tot en met size(); met size() voeg je achteraan toe. Een index buiten dit bereik kan een IndexOutOfBoundsException veroorzaken.

Beide overloads wijzigen de lijst waarop je ze aanroept. Ze geven true terug als de lijst is gewijzigd en anders false. Een lege collectie toevoegen aan een ArrayList geeft bijvoorbeeld false terug. Het resultaat is geen nieuwe lijst. Wil je de eerste lijst ongewijzigd laten, maak dan new ArrayList<>(first) en voeg de elementen van de tweede lijst toe aan die kopie.

Toevoegen is een optionele bewerking: List.of(...) is bruikbaar als bron, maar als doellijst veroorzaakt die een UnsupportedOperationException. Een doellijst die de bewerking niet ondersteunt, kan deze uitzondering gooien voordat ze de argumenten controleert. Een null-argument kan een NullPointerException veroorzaken, net als een null-element als de doellijst dit weigert. Beperkingen aan de klasse of andere eigenschappen van een element kunnen respectievelijk leiden tot ClassCastException of IllegalArgumentException. Wijzig de bron niet tijdens de aanroep: het gedrag is dan ongedefinieerd, ook als een niet-lege lijst haar eigen bron is.

Voorbeelden

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

public class Main {
    public static void main(String[] args) {
        List<String> first = List.of("A", "B");
        List<String> second = List.of("B", "C");
        List<String> result = new ArrayList<>(first);

        System.out.println(result.addAll(second));
        System.out.println(result);

        result.addAll(1, List.of("X", "Y"));
        System.out.println(result);
        System.out.println(result.addAll(List.of()));
    }
}

Resultaat

true
[A, B, B, C]
[A, X, Y, B, B, C]
false

Het programma maakt een wijzigbare kopie van `first`. Als je `second` achteraan toevoegt, krijg je `true` terug en blijven beide exemplaren van `B` behouden. Invoegen op index `1` zet `X` en `Y` achter `A`. Een lege collectie toevoegen geeft `false` terug.

Gerelateerde lessen

  • Java · Les 14 · Gevorderd · Versie: 2
  • Java · Les 54 · Basis · Versie: 2

Bronnen