CKTIS / Java
List.remove(Object): ersten Treffer entfernen
Entferne das erste Vorkommen eines Werts, etwa eines Namens, und prüfe das Ergebnis vom Typ `boolean`. Das Entfernen nach Index funktioniert anders.
Version: Java SE 21
Syntax
boolean remove(Object o); // remove by value
E remove(int index); // remove by zero-based indexList.remove(Object) ändert die Liste direkt. Die Methode entfernt nur das Element am kleinsten Index i, für den Objects.equals(o, get(i)) den Wert true ergibt. Weitere Treffer bleiben erhalten. Bei normaler Rückkehr bedeutet true, dass ein Element entfernt wurde; false bedeutet, dass nichts passte und die Liste unverändert blieb. In unsubscribe ist das String-Argument ein Name, keine Position.
Die Überladung remove(int index) entfernt das Element am angegebenen, bei null beginnenden Index und gibt es als Typ E zurück. Ein ungültiger Index führt zu IndexOutOfBoundsException. Bei List<Integer> entfernt numbers.remove(1) das Element am Index 1, während numbers.remove(Integer.valueOf(7)) den ersten Wert 7 entfernt. Der Compiler wählt anhand des Argumenttyps, nicht anhand des erwarteten Rückgabetyps: Eine passende Überladung ohne Boxing oder Unboxing hat Vorrang.
Das Entfernen ist optional. ArrayList unterstützt es, eine mit List.of(...) erzeugte Liste wirft jedoch auch ohne Treffer UnsupportedOperationException. Je nach Implementierung kann das Entfernen nach Wert bei einem inkompatiblen Typ auch ClassCastException auslösen oder bei null eine NullPointerException, wenn die Liste null nicht erlaubt.
Beispiele
import java.util.ArrayList;
import java.util.List;
public class Main {
static boolean unsubscribe(List<String> names, String name) {
return names.remove(name);
}
public static void main(String[] args) {
List<String> names = new ArrayList<>(List.of("Ada", "Lin", "Ada"));
System.out.println(unsubscribe(names, "Ada"));
System.out.println(names);
System.out.println(unsubscribe(names, "Sam"));
System.out.println(names);
List<Integer> numbers = new ArrayList<>(List.of(7, 9, 7));
System.out.println(numbers.remove(1));
System.out.println(numbers.remove(Integer.valueOf(7)));
System.out.println(numbers);
}
}Ergebnis
true [Lin, Ada] false [Lin, Ada] 9 true [7]
Jedes `new ArrayList<>(List.of(...))` erstellt eine veränderbare Kopie. Das erste `Ada` wird entfernt, das zweite bleibt, und für das fehlende `Sam` kommt `false` zurück. In der Zahlenliste wird zuerst `9` am Index `1` entfernt, danach der erste Wert `7`.
Zugehörige Lektionen
- Java · Lektion 22 · Mittlere Stufe · Version: 2
- Java · Lektion 26 · Mittlere Stufe · Version: 2