WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / Java

Iterator.remove() — ein Element beim Iterieren entfernen

Iterator.remove() entfernt das zuletzt von next() gelieferte Element aus der zugrunde liegenden Sammlung, sofern der Iterator das Entfernen unterstützt.

Version: Java SE 21

Syntax

default void remove()

Iterator.remove() ist eine Standardmethode der Schnittstelle java.util.Iterator<E>. Du rufst sie am Iterator auf, etwa mit it.remove(). Sie nimmt keine Argumente entgegen und liefert keinen Wert (void). Aus der zugrunde liegenden Sammlung entfernt sie genau das Element, das dieser Iterator zuletzt mit next() geliefert hat. Du gibst weder einen Index noch einen Wert an.

Nach einem erfolgreichen Aufruf von next() kannst du das gelieferte Element nur einmal entfernen. hasNext() prüft lediglich, ob ein weiteres Element verfügbar ist. Ein Iterator, der das Entfernen unterstützt, löst IllegalStateException aus, wenn du remove() vor dem ersten erfolgreichen next() oder erneut ohne einen weiteren erfolgreichen Aufruf von next() aufrufst.

Das Entfernen ist optional. Die Standardimplementierung ändert nichts und löst UnsupportedOperationException aus. Der Iterator einer ArrayList unterstützt das Entfernen, der Iterator einer mit List.of() erstellten nicht änderbaren Liste dagegen nicht.

Ändere die Sammlung während der Iteration nicht direkt anstelle von it.remove(): Das Verhalten des Iterators ist dann nicht spezifiziert, sofern die Implementierung keine Regeln für gleichzeitige Änderungen dokumentiert. Der Vertrag von Iterator legt auch das Verhalten von remove() nach forEachRemaining() nicht fest.

Beispiele

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

public class Main {
    public static void main(String[] args) {
        List<Integer> numbers = new ArrayList<>(List.of(1, 2, 4, 5));
        Iterator<Integer> it = numbers.iterator();

        while (it.hasNext()) {
            int number = it.next();
            if (number % 2 == 0) {
                it.remove();
            }
        }

        System.out.println(numbers);
    }
}

Ergebnis

[1, 5]

`List.of()` liefert die Ausgangswerte, und `ArrayList` erstellt eine änderbare Kopie. Die Schleife entfernt die benachbarten geraden Zahlen `2` und `4` jeweils nach einem eigenen Aufruf von `next()` und gibt `[1, 5]` aus.

Zugehörige Lektionen

  • Java · Lektion 57 · Grundlagen · Version: 2

Quellen