CKTIS / Java
Iterable.iterator(): opakované a nezávislé průchody
`Iterable.iterator()` vrací iterátor. Možnost provádět průchody jeden po druhém nezaručuje nezávislost souběžných průchodů ani to, že každé volání vrátí nový objekt iterátoru.
Verze: Java SE 21
Syntaxe
Iterator<T> iterator();Iterable.iterator() je instanční metoda bez argumentů rozhraní java.lang.Iterable<T>. Vrací java.util.Iterator<T> pro průchod prvky typu T. Objekt Iterable zpřístupňuje prvky k procházení, zatímco Iterator sleduje pozici jednoho konkrétního průchodu.
Implementace může umožnit nový průchod po dokončení předchozího, aniž by podporovala průchody, které se překrývají. Může například vrátit tentýž iterátor po jeho nastavení zpět na začátek. Pokud chcete podpořit nezávislé průchody, například ve vnořených cyklech, jednou z jednoduchých možností je při každém volání vrátit nový iterátor s vlastní pozicí nastavenou na začátek. Pokud průchody sdílejí pozici, posun v jednom ovlivní druhý. Obecná smlouva rozhraní Iterable opakovatelnost nezaručuje: druhý pokus získat iterátor z DirectoryStream vyvolá IllegalStateException.
Při ručním procházení před voláním next() ověřte pomocí hasNext(), zda zbývá další prvek. První metoda prvek nespotřebuje, druhá jej vrátí a posune pozici. Pokud už žádný prvek nezbývá, next() vyvolá NoSuchElementException. Rozšířený cyklus for nad Iterable zavolá iterator() jednou na začátku a pak používá hasNext() a next(). U polí používá místo toho indexy.
Příklady
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);
}
}
}
Výsledek
a: 1 a: 2 b: 1 for: 1 for: 2 for: 3
`a` vrátí 1 a poté 2, ale `b` přesto začíná od 1. Rozšířený cyklus `for` získá třetí iterátor a vypíše čísla od 1 do 3.
Související lekce
- Java · Lekce 24 · Středně pokročilá · Verze: 2