WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / Java

List.add — ein Element zu einer Liste hinzufügen

`List.add(E)` hängt ein Element an das Ende einer Liste an und gibt bei Erfolg `true` zurück. Die Überladung mit Index fügt ein Element an der gewählten Position ein.

Version: Java SE 21

Syntax

boolean add(E e)
void add(int index, E element)

In Java SE 21 bietet die Schnittstelle java.util.List<E> zwei Überladungen von List.add. Die Methode mit einem Argument, List.add(E), hängt ein Element an die bestehende Liste an. E bezeichnet den Elementtyp, etwa String in List<String>. Die Reihenfolge der vorhandenen Elemente bleibt erhalten. Bei Erfolg gibt die Methode true zurück, keinen Index und keine neue Liste. ArrayList erlaubt Duplikate und null-Werte.

add(int index, E element) fügt an einer Position ein, deren Zählung bei null beginnt, und hat den Rückgabetyp void. Das Element an dieser Position und alle nachfolgenden Elemente rücken um eine Stelle nach rechts. index == size() hängt das Element an. Ein Index außerhalb von 0 <= index && index <= size() ist ungültig und führt bei unterstützter Einfügeoperation zu einer IndexOutOfBoundsException. Anders als set(index, element) ersetzt das Einfügen kein Element.

Das Hinzufügen ist optional: Der Typ List<E> allein garantiert nicht, dass eine konkrete Liste neue Elemente annimmt. Ein nicht unterstützter Aufruf löst eine UnsupportedOperationException aus, statt false zurückzugeben. Auch wenn das Hinzufügen unterstützt wird, kann die Liste null mit einer NullPointerException, einen unzulässigen Typ mit einer ClassCastException oder eine unzulässige Elementeigenschaft mit einer IllegalArgumentException ablehnen.

List.of(...) erstellt eine nicht veränderbare Liste. Arrays.asList(...) liefert eine auf einem Array basierende Liste, deren Elemente ersetzt werden können, deren Größe aber fest ist. Keine der beiden Listen unterstützt add. Für eine separate Liste, die wachsen kann, verwende new ArrayList<>(source). Das Anhängen an die Kopie ändert die Quellliste nicht.

Beispiele

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

public class Main {
    public static void main(String[] args) {
        List<String> source = List.of("alpha", "beta");
        List<String> tags = new ArrayList<>(source);

        boolean added = tags.add("alpha");
        tags.add(1, "gamma");

        System.out.println(added);
        System.out.println(tags);
        System.out.println(source);

        try {
            source.add("delta");
        } catch (UnsupportedOperationException e) {
            System.out.println("UnsupportedOperationException");
        }
    }
}

Ergebnis

true
[alpha, gamma, beta, alpha]
[alpha, beta]
UnsupportedOperationException

Das Anhängen eines zweiten `alpha` an `tags` gibt `true` zurück. Das Einfügen von `gamma` am Index `1` verschiebt `beta` und das zweite `alpha` nach rechts. `source` bleibt unverändert und weist den Versuch zurück, `delta` hinzuzufügen.

Zugehörige Lektionen

  • Java · Lektion 1 · Fortgeschritten · Version: 2
  • Java · Lektion 2 · Fortgeschritten · Version: 2
  • Java · Lektion 6 · Fortgeschritten · Version: 2
  • Java · Lektion 8 · Fortgeschritten · Version: 2
  • Java · Lektion 10 · Fortgeschritten · Version: 2
  • Java · Lektion 13 · Fortgeschritten · Version: 2
  • Java · Lektion 21 · Fortgeschritten · Version: 2
  • Java · Lektion 33 · Fortgeschritten · Version: 2
  • Java · Lektion 35 · Fortgeschritten · Version: 2
  • Java · Lektion 36 · Fortgeschritten · Version: 2
  • Java · Lektion 38 · Fortgeschritten · Version: 2
  • Java · Lektion 19 · Grundlagen · Version: 2
  • Java · Lektion 29 · Grundlagen · Version: 2
  • Java · Lektion 39 · Grundlagen · Version: 2
  • Java · Lektion 44 · Grundlagen · Version: 2
  • Java · Lektion 54 · Grundlagen · Version: 2
  • Java · Lektion 57 · Grundlagen · Version: 2
  • Java · Lektion 59 · Grundlagen · Version: 2
  • Java · Lektion 62 · Grundlagen · Version: 2
  • Java · Lektion 2 · Mittlere Stufe · Version: 2
  • Java · Lektion 5 · Mittlere Stufe · Version: 2
  • Java · Lektion 6 · Mittlere Stufe · Version: 2
  • Java · Lektion 33 · Mittlere Stufe · Version: 2
  • Java · Lektion 34 · Mittlere Stufe · Version: 2
  • Java · Lektion 36 · Mittlere Stufe · Version: 2
  • Java · Lektion 39 · Mittlere Stufe · Version: 2
  • Java · Lektion 50 · Mittlere Stufe · Version: 2

Quellen