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.