CKTIS / Java
List.add(E) — ein Element an eine Liste anhängen
`List.add(E)` hängt ein Element an die bestehende Liste an und gibt bei normaler Rückkehr `true` zurück. Nicht jede Liste unterstützt das Hinzufügen.
Version: Java SE 21
Syntax
boolean add(E e)
boolean added = items.add(element);List.add(E) ist die Methode mit einem Argument in java.util.List<E>. E ist der Elementtyp, etwa Customer in einem Repository, das eine List<Customer> verwendet. Die Methode ändert die bestehende Liste: Das neue Element steht am Ende, die bisherigen Elemente behalten ihre Reihenfolge. Bei normaler Rückkehr erhältst du true, keinen Index und keine neue Liste.
Die Liste speichert die übergebene Referenz, keine Kopie des Objekts. Eine ArrayList kann dieselbe Referenz mehrfach speichern; Änderungen am gemeinsamen Objekt sind an jeder Position sichtbar, die darauf verweist. Listen lassen üblicherweise Duplikate zu. Mit wiederholten add-Aufrufen kannst du daher Ereignisse oder Empfänger in der Reihenfolge erfassen, in der du sie hinzufügst.
Das Anhängen ist optional: Eine mit List.of(...) erzeugte Liste ist unveränderbar und wirft UnsupportedOperationException. Auch eine Liste, die das Anhängen unterstützt, kann ein Element ablehnen: mit NullPointerException bei unzulässigem null, ClassCastException bei einer unzulässigen Elementklasse oder IllegalArgumentException bei einer anderen unzulässigen Eigenschaft des Elements. ArrayList erlaubt null.
Die Überladung add(int index, E element) gibt void zurück und fügt an einem Index von 0 bis einschließlich size() ein. Elemente ab dieser Position rücken nach hinten. Verwende beim Rückgängigmachen einer Entfernung den gespeicherten Index, wenn die ursprüngliche Position wiederhergestellt werden soll; add(element) hängt nur an. Seit Java 21 hängt auch addLast(E) an, gibt aber void zurück.
Beispiele
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);
}
}Ergebnis
true [Ada, Lin, Ada] true [Ada!, Lin, Ada!]
Das erste `true` ist das Ergebnis von `add`, das zweite das Ergebnis des Referenzvergleichs mit `==`. Nach der Änderung von `first` zeigen beide Positionen `Ada!`, weil sie auf dasselbe Objekt verweisen.
Zugehörige Lektionen
- Java · Lektion 21 · Mittlere Stufe · Version: 2
- Java · Lektion 22 · Mittlere Stufe · Version: 2
- Java · Lektion 26 · Mittlere Stufe · Version: 2
- Java · Lektion 27 · Mittlere Stufe · Version: 2
- Java · Lektion 32 · Mittlere Stufe · Version: 2