Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / Java

Iterable.iterator(): powtarzanie przejść a ich niezależność

Metoda `Iterable.iterator()` zwraca iterator. Możliwość wykonania kilku przejść jedno po drugim nie gwarantuje, że mogą one przebiegać niezależnie, gdy się nakładają, ani że każde wywołanie zwróci nowy obiekt iteratora.

Wersja: Java SE 21

Składnia

Iterator<T> iterator();

Iterable.iterator() to bezargumentowa metoda instancji interfejsu java.lang.Iterable<T>. Zwraca java.util.Iterator<T> do przechodzenia po elementach typu T. Obiekt Iterable udostępnia elementy do przejścia, a Iterator śledzi pozycję w jednym konkretnym przejściu.

Implementacja może pozwalać na rozpoczęcie kolejnego przejścia po zakończeniu poprzedniego, nie obsługując nakładających się przejść. W takim przypadku może na przykład zresetować i ponownie wykorzystać ten sam iterator. Jeśli chcesz obsługiwać niezależne przejścia, na przykład w zagnieżdżonych pętlach, prostym rozwiązaniem jest zwracanie przy każdym wywołaniu nowego iteratora z własną pozycją ustawioną na początku. Gdyby przejścia współdzieliły pozycję, przesunięcie jej w jednym przejściu wpłynęłoby na drugie. Ogólny kontrakt Iterable nie gwarantuje wielokrotnego przechodzenia: DirectoryStream przy drugiej próbie pobrania iteratora zgłasza IllegalStateException.

Przy ręcznym przechodzeniu sprawdzaj hasNext() przed wywołaniem next(). Pierwsza metoda sprawdza, czy pozostał element, bez jego zużywania; druga zwraca go i przesuwa pozycję. Gdy elementy się skończą, next() zgłasza NoSuchElementException. Rozszerzona pętla for dla Iterable wywołuje iterator() raz na początku, a potem używa hasNext() i next(). Dla tablic używa indeksów zamiast iteratora.

Przykłady

import java.util.Iterator;
import java.util.NoSuchElementException;

public class Main {
    static final class OneToThree implements Iterable<Integer> {
        @Override
        public Iterator<Integer> iterator() {
            return new Iterator<Integer>() {
                private int nextValue = 1;

                @Override
                public boolean hasNext() {
                    return nextValue <= 3;
                }

                @Override
                public Integer next() {
                    if (!hasNext()) {
                        throw new NoSuchElementException();
                    }
                    return nextValue++;
                }
            };
        }
    }

    public static void main(String[] args) {
        Iterable<Integer> numbers = new OneToThree();
        Iterator<Integer> a = numbers.iterator();
        Iterator<Integer> b = numbers.iterator();

        System.out.println("a: " + a.next());
        System.out.println("a: " + a.next());
        System.out.println("b: " + b.next());

        for (int number : numbers) {
            System.out.println("for: " + number);
        }
    }
}

Wynik

a: 1
a: 2
b: 1
for: 1
for: 2
for: 3

`a` zwraca 1, a potem 2, ale `b` wciąż zaczyna od 1. Rozszerzona pętla `for` pobiera trzeci iterator i wypisuje liczby od 1 do 3.

Powiązane lekcje

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

Źródła