Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

CKTIS / Java

Iterable — smlouva pro procházení prvků

java.lang.Iterable<T> umožňuje použít objekt v rozšířeném cyklu for. Metoda iterator() poskytuje iterátor a výchozí metoda forEach() provádí akci nad následujícími prvky.

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

Syntaxe

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

java.lang.Iterable<T> umožňuje použít objekt v rozšířeném cyklu for; T určuje typ prvků. Jde o smlouvu pro procházení prvků, nikoli o konkrétní kontejner.

Iterable.iterator() vrací Iterator<T>. Rozlišujte objekt, který iteraci poskytuje, od iterátoru, jenž sleduje její průběh: hasNext() ověřuje, zda je k dispozici prvek, a next() jej získá. Pokud není k dispozici žádný prvek, next() vyvolá NoSuchElementException.

Iterable.forEach(Consumer<? super T> action) je výchozí metoda. Zpracovává prvky v pořadí iterace, pokud je určeno. Výjimka akce zpracování zastaví a předá se volajícímu; akce null způsobí NullPointerException. Ve zdrojových datech v akci neprovádějte změny: chování není určeno, pokud implementace nedefinuje vhodná pravidla.

Příklad implementuje iterator() pomocí uspořádaného seznamu List.of("A", "B") a dědí forEach(). Každé volání iterator() zde vytvoří nový iterátor, takže oba průchody vypíší oba prvky.

Příklady

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

Výsledek

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

Zobrazený kód a uvedený výsledek byly ověřeny v izolovaném prostředí metodou zaznamenanou v dokladu o ověření této přesné verze.

Zdroje