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

CKTIS / Java

Iterable — договор за обхождане на елементи

java.lang.Iterable<T> позволява обект да се използва в разширен цикъл for. Методът iterator() предоставя итератор, а методът по подразбиране forEach() прилага действие към последователните елементи.

Версия: Java SE 21; repository runtime, production runtime not attested

Синтаксис

public interface Iterable<T>
Iterator<T> iterator()
default void forEach(Consumer<? super T> action)

java.lang.Iterable<T> позволява обект да се използва в разширен цикъл for; T задава типа на елементите. Това е договор за обхождане на елементи, а не конкретен контейнер.

Iterable.iterator() връща Iterator<T>. Разграничавайте обекта, който предоставя итерацията, от итератора, който следи напредъка ѝ: hasNext() проверява дали има наличен елемент, а next() го извлича. Ако няма наличен елемент, next() хвърля NoSuchElementException.

Iterable.forEach(Consumer<? super T> action) е метод по подразбиране. Той обработва елементите в реда на итерацията, ако такъв е зададен. Изключение от действието прекратява обработката и се предава на извикващия; действие null причинява NullPointerException. Не променяйте източника в действието: поведението не е специфицирано, освен ако имплементацията не задава подходяща политика.

Примерът имплементира iterator() чрез подредения списък List.of("A", "B") и наследява forEach(). Тук всяко извикване на iterator() създава нов итератор, затова и двете обхождания отпечатват двата елемента.

Примери

import java.util.Iterator;
import java.util.List;

public class Main implements Iterable<String> {
    @Override
    public Iterator<String> iterator() {
        return List.of("A", "B").iterator();
    }

    public static void main(String[] args) {
        Main letters = new Main();
        for (String letter : letters) {
            System.out.println("loop: " + letter);
        }
        letters.forEach(letter -> System.out.println("action: " + letter));
    }
}

Резултат

loop: A
loop: B
action: A
action: B

Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.

Източници