Baza znanjaCentar za ispite
HRHrvatski
Odaberi jezik13

CKTIS / Java

Iterable — ugovor za prolazak kroz elemente

java.lang.Iterable<T> omogućuje upotrebu objekta u proširenoj for-petlji. Metoda iterator() daje iterator, a zadana metoda forEach() primjenjuje radnju na uzastopne elemente.

Verzija: 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> omogućuje upotrebu objekta u proširenoj for-petlji; T određuje vrstu elemenata. Riječ je o ugovoru za prolazak kroz elemente, a ne o konkretnom spremniku.

Iterable.iterator() vraća Iterator<T>. Razlikujte objekt koji omogućuje iteraciju od iteratora koji prati njezin napredak: hasNext() provjerava je li element dostupan, a next() ga dohvaća. Ako nijedan element nije dostupan, next() izbacuje NoSuchElementException.

Iterable.forEach(Consumer<? super T> action) zadana je metoda. Obrađuje elemente redoslijedom iteracije, ako je određen. Iznimka radnje zaustavlja obradu i prosljeđuje se pozivatelju; radnja null uzrokuje NullPointerException. Nemojte mijenjati izvor u radnji: ponašanje nije određeno, osim ako implementacija ne definira odgovarajuće pravilo.

Primjer implementira iterator() pomoću uređenog popisa List.of("A", "B") i nasljeđuje forEach(). Svaki poziv metode iterator() ovdje stvara novi iterator pa oba prolaska ispisuju oba elementa.

Primjeri

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

Prikazani kôd i navedeni rezultat provjereni su u izoliranom okruženju metodom zabilježenom u dokazu provjere za ovu točnu verziju.

Izvori