WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / Java

List.addAll — Elemente anhängen oder einfügen

Mit `List.addAll` hängst du die Elemente einer Collection an eine Liste an oder fügst sie an einem bestimmten Index ein. Der Rückgabewert vom Typ `boolean` zeigt, ob sich die Zielliste geändert hat.

Version: Java SE 21

Syntax

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

In Java SE 21 bietet das Interface java.util.List<E> zwei Überladungen von List.addAll. List.addAll(Collection) hängt die Elemente in der Reihenfolge an die Zielliste an, in der der Iterator der Quell-Collection sie liefert. Ist die Quelle eine andere Liste, folgen ihre Elemente in ihrer ursprünglichen Reihenfolge auf die vorhandenen Elemente der Zielliste. Die Methode sortiert nicht und entfernt keine Duplikate. Collection<? extends E> bedeutet, dass die Quelle keine Liste sein muss und ihr deklarierter Elementtyp E oder ein Untertyp von E sein kann.

List.addAll(int, Collection) fügt die Elemente ab einem nullbasierten Index in derselben Quellreihenfolge ein. Vorhandene Elemente ab der Einfügeposition rücken nach rechts. Erlaubt sind Indizes von 0 bis einschließlich size(); bei size() werden die Elemente angehängt. Ein Index außerhalb dieses Bereichs kann zu einer IndexOutOfBoundsException führen.

Beide Überladungen ändern die Liste, auf der sie aufgerufen werden. Sie geben true zurück, wenn sich die Liste geändert hat, sonst false. Bei einer leeren Quell-Collection gibt etwa eine ArrayList false zurück. Der Rückgabewert ist keine neue Liste. Soll die erste Liste unverändert bleiben, erstelle new ArrayList<>(first) und füge die Elemente der zweiten Liste dieser Kopie hinzu.

Das Hinzufügen ist optional: List.of(...) eignet sich als Quelle, löst als Ziel aber eine UnsupportedOperationException aus. Unterstützt die Zielliste die Operation nicht, kann sie diese Ausnahme auslösen, bevor sie die Argumente prüft. Ein null-Argument kann zu einer NullPointerException führen, ebenso ein null-Element, wenn die Zielliste es nicht zulässt. Einschränkungen der Klasse oder anderer Eigenschaften eines Elements können zu einer ClassCastException beziehungsweise IllegalArgumentException führen. Ändere die Quelle während des Aufrufs nicht: Das Verhalten ist dann nicht definiert, auch wenn eine nicht leere Liste ihre eigene Quelle ist.

Beispiele

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()));
    }
}

Ergebnis

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

Das Programm erstellt eine veränderbare Kopie von `first`. Das Anhängen von `second` gibt `true` zurück und behält beide Vorkommen von `B`. Beim Einfügen an Index `1` landen `X` und `Y` hinter `A`. Das Hinzufügen einer leeren Collection gibt `false` zurück.

Zugehörige Lektionen

  • Java · Lektion 14 · Fortgeschritten · Version: 2
  • Java · Lektion 54 · Grundlagen · Version: 2

Quellen