CKTIS / Java
Iterable.iterator(): opakované a nezávislé prechody
`Iterable.iterator()` vracia iterátor. Možnosť vykonať prechody jeden po druhom nezaručuje nezávislosť prekrývajúcich sa prechodov ani to, že každé volanie vráti nový objekt iterátora.
Verzia: Java SE 21
Syntax
Iterator<T> iterator();Iterable.iterator() je inštančná metóda bez argumentov rozhrania java.lang.Iterable<T>. Vracia java.util.Iterator<T> na prechádzanie prvkami typu T. Objekt Iterable sprístupňuje prvky na prechádzanie, kým Iterator sleduje pozíciu jedného konkrétneho prechodu.
Implementácia môže umožniť nový prechod po dokončení predchádzajúceho bez toho, aby podporovala prekrývajúce sa prechody. Môže napríklad nastaviť ten istý iterátor späť na začiatok a opäť ho použiť. Ak chcete podporiť nezávislé prechody, napríklad vo vnorených cykloch, jednoduchou možnosťou je pri každom volaní vrátiť nový iterátor s vlastnou pozíciou nastavenou na začiatok. Ak prechody zdieľajú pozíciu, posun v jednom ovplyvní druhý. Všeobecný kontrakt rozhrania Iterable nezaručuje opakovateľnosť: druhý pokus získať iterátor z DirectoryStream vyvolá IllegalStateException.
Pri ručnom prechádzaní pred volaním next() overte pomocou hasNext(), či zostáva ďalší prvok. Prvá metóda prvok nespotrebuje, druhá ho vráti a posunie pozíciu. Keď už nezostáva žiadny prvok, next() vyvolá NoSuchElementException. Rozšírený cyklus for nad Iterable zavolá iterator() raz na začiatku a potom používa hasNext() a next(). Pri poliach namiesto toho používa indexy.
Prí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ýsledok
a: 1 a: 2 b: 1 for: 1 for: 2 for: 3
`a` vráti 1 a potom 2, ale `b` aj tak začína od 1. Rozšírený cyklus `for` získa tretí iterátor a vypíše čísla od 1 do 3.
Súvisiace lekcie
- Java · Lekcia 24 · Stredne pokročilá · Verzia: 2