CKTIS / Java
List.clear(): Eine Liste in Java leeren
`List.clear()` entfernt alle Elemente aus einer bestehenden Liste. Die Methode gibt keinen Wert zurück, und nicht jede Liste unterstützt den Aufruf.
Version: Java SE 21
Syntax
void clear()
list.clear();List.clear() ist eine Instanzmethode der Schnittstelle java.util.List. Der Aufruf list.clear() benötigt keine Argumente. Der Rückgabetyp void bedeutet, dass die Methode keinen Wert zurückgibt. Nach einem erfolgreichen Aufruf liefert list.size() den Wert 0 und list.isEmpty() den Wert true.
Die Methode ändert die bestehende Liste, statt eine neue zu erzeugen. Verweisen zwei Variablen auf dieselbe Liste, sehen beide nach dem Aufruf die leere Liste. Weist man einer Variablen eine neue Liste zu, wird die ursprüngliche Liste dadurch nicht geleert.
Das Leeren ist eine optionale Operation. ArrayList unterstützt sie, aber mit List.of(...) oder List.copyOf(...) erzeugte Listen lösen eine UnsupportedOperationException aus, selbst wenn sie bereits leer sind. Um eine Kopie zu leeren, ohne das Original zu ändern, erstelle zuerst new ArrayList<>(list) und rufe clear() für die Kopie auf.
Beispiele
import java.util.ArrayList;
import java.util.List;
public class Main {
public static void main(String[] args) {
List<String> items = new ArrayList<>(List.of("A", "B"));
List<String> sameList = items;
System.out.println(items.size());
items.clear();
System.out.println(items.size());
System.out.println(sameList.isEmpty());
}
}Ergebnis
2 0 true
`items` und `sameList` verweisen auf dieselbe `ArrayList`. Die Ausgabe zeigt die Größe `2` vor dem Aufruf, die Größe `0` danach und `true` für `sameList.isEmpty()`.
Zugehörige Lektionen
- Java · Lektion 54 · Grundlagen · Version: 2