WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

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 index

List.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

Quellen