Baza znanjaIzpitno središče
SLSlovenščina
Izberi jezik13

CKTIS / Java

Iterable — pogodba za prehajanje elementov

java.lang.Iterable<T> omogoča uporabo objekta v razširjeni zanki for. Metoda iterator() zagotovi iterator, privzeta metoda forEach() pa izvede dejanje za zaporedne elemente.

Različica: Java SE 21; repository runtime, production runtime not attested

Sintaksa

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

java.lang.Iterable<T> omogoča uporabo objekta v razširjeni zanki for; T določa tip elementov. Gre za pogodbo za prehajanje elementov, ne za konkreten vsebnik.

Iterable.iterator() vrne Iterator<T>. Razlikujte objekt, ki omogoča iteracijo, od iteratorja, ki spremlja njen potek: hasNext() preveri, ali je element na voljo, next() pa ga pridobi. Če ni na voljo noben element, next() sproži NoSuchElementException.

Iterable.forEach(Consumer<? super T> action) je privzeta metoda. Elemente obdela v vrstnem redu iteracije, če je ta določen. Izjema dejanja prekine obdelavo in se posreduje klicatelju; dejanje null povzroči NullPointerException. V dejanju ne spreminjajte vira: vedenje ni določeno, razen če implementacija opredeli ustrezno pravilo.

Primer implementira iterator() z urejenim seznamom List.of("A", "B") in podeduje forEach(). Vsak klic iterator() tukaj ustvari nov iterator, zato oba prehoda izpišeta oba elementa.

Primeri

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

Rezultat

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

Prikazana koda in navedeni rezultat sta bila preverjena v izoliranem okolju z metodo, zapisano v dokazilu o preverjanju te natančne različice.

Viri