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