База знанияИзпитен център
BGБългарски
Избери език13

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

Източници