Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / Java

Iterable — un contratto per attraversare gli elementi

java.lang.Iterable<T> consente di usare un oggetto in un ciclo for avanzato. Il metodo iterator() fornisce un iteratore, mentre il metodo predefinito forEach() applica un’azione agli elementi successivi.

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

Sintassi

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

java.lang.Iterable<T> consente di usare un oggetto in un ciclo for avanzato; T indica il tipo degli elementi. È un contratto per attraversare gli elementi, non un contenitore concreto.

Iterable.iterator() restituisce un Iterator<T>. Distingui l’oggetto che fornisce l’iterazione dall’iteratore che ne segue l’avanzamento: hasNext() verifica se è disponibile un elemento e next() lo recupera. Se non è disponibile alcun elemento, next() genera una NoSuchElementException.

Iterable.forEach(Consumer<? super T> action) è un metodo predefinito. Elabora gli elementi nell’ordine di iterazione, se specificato. Un’eccezione dell’azione interrompe l’elaborazione e viene propagata al chiamante; un’azione null causa una NullPointerException. Non modificare la sorgente nell’azione: il comportamento non è specificato, a meno che l’implementazione non definisca una politica adeguata.

L’esempio implementa iterator() usando la lista ordinata List.of("A", "B") ed eredita forEach(). Qui ogni chiamata a iterator() crea un nuovo iteratore, quindi entrambi gli attraversamenti stampano entrambi gli elementi.

Esempi

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

Risultato

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

Il codice mostrato e il risultato dichiarato sono stati verificati in un ambiente isolato con il metodo registrato nella prova di verifica di questa versione esatta.

Fonti