Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / Java

Iterable — kontrakt przechodzenia po elementach

java.lang.Iterable<T> umożliwia użycie obiektu w rozszerzonej pętli for. Metoda iterator() dostarcza iterator, a domyślna forEach() wykonuje wskazaną akcję dla kolejnych elementów.

Wersja: Java SE 21; repository runtime, production runtime not attested

Składnia

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

java.lang.Iterable<T> pozwala użyć obiektu w rozszerzonej pętli for; T określa typ elementów. To kontrakt przechodzenia po elementach, nie konkretny pojemnik.

Iterable.iterator() zwraca Iterator<T>. Rozróżniaj obiekt udostępniający iterację od iteratora śledzącego jej postęp: hasNext() sprawdza dostępność elementu, a next() go pobiera. Przy braku elementu next() zgłasza NoSuchElementException.

Iterable.forEach(Consumer<? super T> action) jest metodą domyślną. Przetwarza elementy w kolejności iteracji, jeśli została określona. Wyjątek akcji przerywa przetwarzanie i trafia do wywołującego; null jako akcja powoduje NullPointerException. Nie modyfikuj źródła w akcji: zachowanie jest nieokreślone, chyba że implementacja definiuje odpowiednią politykę.

Przykład implementuje iterator() za pomocą uporządkowanej listy List.of("A", "B") i dziedziczy forEach(). Każde wywołanie iterator() tworzy tu nowy iterator, więc oba przejścia wypisują oba elementy.

Przykłady

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));
    }
}

Wynik

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

Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.

Źródła