Znalostná bázaCentrum skúšok
SKSlovenčina
Vybrať jazyk13

CKTIS / Java

Iterable — zmluva na prechádzanie prvkov

java.lang.Iterable<T> umožňuje použiť objekt v rozšírenom cykle for. Metóda iterator() poskytuje iterátor a predvolená metóda forEach() vykonáva akciu nad nasledujúcimi prvkami.

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

Syntax

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

java.lang.Iterable<T> umožňuje použiť objekt v rozšírenom cykle for; T určuje typ prvkov. Je to zmluva na prechádzanie prvkov, nie konkrétny kontajner.

Iterable.iterator() vracia Iterator<T>. Rozlišujte objekt, ktorý poskytuje iteráciu, od iterátora, ktorý sleduje jej postup: hasNext() kontroluje, či je dostupný prvok, a next() ho získa. Ak nie je dostupný žiadny prvok, next() vyvolá NoSuchElementException.

Iterable.forEach(Consumer<? super T> action) je predvolená metóda. Spracúva prvky v poradí iterácie, ak je určené. Výnimka akcie zastaví spracovanie a propaguje sa volajúcemu; akcia null spôsobí NullPointerException. V akcii nemeňte zdroj: správanie nie je určené, pokiaľ implementácia nedefinuje vhodné pravidlá.

Príklad implementuje iterator() pomocou usporiadaného zoznamu List.of("A", "B") a dedí forEach(). Každé volanie iterator() tu vytvorí nový iterátor, takže oba priechody vypíšu oba prvky.

Prí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ýsledok

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

Zobrazený kód a uvedený výsledok boli overené v izolovanom prostredí metódou zaznamenanou v dôkaze o overení tejto presnej verzie.

Zdroje