Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / Java

Metody iteratora w Javie: hasNext(), next() i remove()

Sprawdź, czy iterator ma kolejny element, pobierz go i w razie potrzeby usuń. Dowiedz się, jak odróżnić koniec iteracji, niedozwoloną kolejność wywołań i brak obsługi usuwania.

Wersja: Java SE 21

Składnia

java.util.Iterator<E>
boolean hasNext()
E next()
default void remove()

W interfejsie java.util.Iterator<E> metoda hasNext() zwraca true, jeśli pozostał kolejny element, albo false, jeśli go nie ma. Tylko sprawdza dostępność: nie pobiera elementu ani nie przesuwa pozycji iteratora. Dwa kolejne sprawdzenia nie pomijają więc żadnego elementu.

Metoda next() zwraca kolejny element typu E i przesuwa iterator. Po wyczerpaniu elementów rzuca NoSuchElementException, zamiast zwrócić null na znak końca. Typowa pętla sprawdza while (it.hasNext()) i wywołuje it.next() w swoim ciele.

Metoda remove() jest opcjonalna i nie przyjmuje argumentów. Jeśli iterator ją obsługuje, usuwa z kolekcji źródłowej ostatni element zwrócony przez ten sam iterator. Można to zrobić tylko raz po każdym udanym next(). Wywołanie przed pierwszym next() lub ponowne usunięcie bez kolejnego udanego next() powoduje IllegalStateException. Jeśli iterator nie obsługuje usuwania, remove() rzuca UnsupportedOperationException; domyślna implementacja zgłasza ten wyjątek i niczego nie zmienia.

Nie modyfikuj kolekcji źródłowej w trakcie iteracji inaczej niż przez remove() tego iteratora, chyba że implementacja określa zasady współbieżnej modyfikacji. W przeciwnym razie zachowanie iteratora jest nieokreślone. Ogólny kontrakt nie określa też zachowania remove() po forEachRemaining().

Przykłady

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

public class Main {
    public static void main(String[] args) {
        List<String> items = new ArrayList<>(List.of("A", "B"));
        Iterator<String> it = items.iterator();

        System.out.println(it.hasNext());
        System.out.println(it.hasNext());
        System.out.println(it.next());
        it.remove();
        try {
            it.remove();
        } catch (IllegalStateException e) {
            System.out.println("IllegalStateException");
        }
        while (it.hasNext()) {
            System.out.println(it.next());
        }
        System.out.println(it.hasNext());
        try {
            it.next();
        } catch (NoSuchElementException e) {
            System.out.println("NoSuchElementException");
        }
        System.out.println(items);

        Iterator<String> readOnly = List.of("A").iterator();
        readOnly.next();
        try {
            readOnly.remove();
        } catch (UnsupportedOperationException e) {
            System.out.println("UnsupportedOperationException");
        }
    }
}

Wynik

true
true
A
IllegalStateException
B
false
NoSuchElementException
[B]
UnsupportedOperationException

Dwa wywołania `hasNext()` dają `true`, a pierwszy `next()` nadal zwraca `A`. Iterator `ArrayList` usuwa `A`, odrzuca powtórne usunięcie i po zwróceniu `B` jest wyczerpany. Lista zawiera tylko `B`. Iterator niemodyfikowalnej listy z `List.of(...)` odrzuca usunięcie nawet po udanym `next()`.

Powiązane lekcje

  • Java · Lekcja 24 · Średniozaawansowany · Wersja: 2

Źródła