CKTIS / Java
Iterator.remove() — usuwanie elementu podczas iteracji
Metoda Iterator.remove() usuwa z kolekcji ostatni element zwrócony przez next(), jeśli dany iterator obsługuje usuwanie.
Wersja: Java SE 21
Składnia
default void remove()Iterator.remove() to metoda domyślna interfejsu java.util.Iterator<E>. Wywołujesz ją na iteratorze, na przykład jako it.remove(). Nie przyjmuje argumentów i niczego nie zwraca (void). Usuwa z kolekcji, po której iterujesz, dokładnie ten element, który ten iterator ostatnio zwrócił przez next(). Nie podajesz indeksu ani wartości.
Po udanym wywołaniu next() możesz usunąć zwrócony element tylko raz. hasNext() jedynie sprawdza, czy jest kolejny element. Iterator obsługujący usuwanie zgłasza IllegalStateException, jeśli wywołasz remove() przed pierwszym udanym next() albo ponownie bez kolejnego udanego next().
Usuwanie to operacja opcjonalna. Domyślna implementacja niczego nie usuwa i zgłasza UnsupportedOperationException. Iterator z ArrayList obsługuje usuwanie, natomiast iterator niemodyfikowalnej listy utworzonej przez List.of() go nie obsługuje.
Nie zastępuj it.remove() bezpośrednią modyfikacją kolekcji w trakcie iteracji: zachowanie iteratora jest wtedy nieokreślone, chyba że implementacja określa zasady współbieżnych modyfikacji. Kontrakt Iterator nie określa też zachowania remove() po wywołaniu forEachRemaining().
Przykłady
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);
}
}Wynik
[1, 5]
`List.of()` dostarcza dane początkowe, a `ArrayList` tworzy ich modyfikowalną kopię. Pętla usuwa kolejno sąsiadujące liczby parzyste `2` i `4`, każdą po osobnym `next()`, i wypisuje `[1, 5]`.
Powiązane lekcje
- Java · Lekcja 57 · Podstawowy · Wersja: 2