CKTIS / Java
Iterable.iterator(): последователни и независими обхождания
`Iterable.iterator()` връща итератор. Възможността за последователни обхождания не гарантира, че застъпващите се обхождания са независими или че всяко извикване връща нов обект на итератор.
Версия: Java SE 21
Синтаксис
Iterator<T> iterator();Iterable.iterator() е метод на екземпляра без аргументи в интерфейса java.lang.Iterable<T>. Той връща java.util.Iterator<T> за обхождане на елементи от тип T. Обектът Iterable предоставя елементите за обхождане, а Iterator следи позицията в едно конкретно обхождане.
Реализацията може да позволява ново обхождане след края на предишното, без да поддържа застъпващи се обхождания. Например тя може да върне същия итератор в началната позиция и да го използва отново. Ако искаш да поддържаш независими обхождания, например във вложени цикли, един прост подход е при всяко извикване да връщаш нов итератор със собствена позиция, зададена в началото на обхождането. Ако обхожданията споделят позицията, придвижването в едното се отразява на другото. Общият договор на Iterable не гарантира повторно обхождане: при втори опит да се получи итератор от DirectoryStream се хвърля IllegalStateException.
При ръчно обхождане проверявай с hasNext(), преди да извикаш next(). Първият метод проверява дали има още елемент, без да го консумира; вторият го връща и премества позицията напред. Когато няма повече елементи, next() хвърля NoSuchElementException. При Iterable разширеният цикъл for извиква iterator() веднъж в началото и след това използва hasNext() и next(). При масиви вместо това използва индекси.
Примери
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);
}
}
}
Резултат
a: 1 a: 2 b: 1 for: 1 for: 2 for: 3
`a` връща 1, а след това 2, но `b` все пак започва от 1. Разширеният цикъл `for` получава трети итератор и извежда числата от 1 до 3.
Свързани уроци
- Java · Урок 24 · Средно · Версия: 2