Base de conocimientosCentro de exámenes
ESEspañol
Elegir idioma13

CKTIS / Java

Iterable — un contrato para recorrer elementos

java.lang.Iterable<T> permite usar un objeto en un bucle for mejorado. Su método iterator() proporciona un iterador, mientras que el método predeterminado forEach() aplica una acción a los elementos sucesivos.

Versión: Java SE 21; repository runtime, production runtime not attested

Sintaxis

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

java.lang.Iterable<T> permite usar un objeto en un bucle for mejorado; T indica el tipo de los elementos. Es un contrato para recorrer elementos, no un contenedor concreto.

Iterable.iterator() devuelve un Iterator<T>. Distingue el objeto que proporciona la iteración del iterador que sigue su progreso: hasNext() comprueba si hay un elemento disponible y next() lo obtiene. Si no hay ningún elemento disponible, next() lanza una NoSuchElementException.

Iterable.forEach(Consumer<? super T> action) es un método predeterminado. Procesa los elementos en el orden de iteración, si está especificado. Una excepción de la acción detiene el procesamiento y se propaga al llamador; una acción null provoca una NullPointerException. No modifiques la fuente dentro de la acción: el comportamiento no está especificado, a menos que la implementación defina una política adecuada.

El ejemplo implementa iterator() mediante la lista ordenada List.of("A", "B") y hereda forEach(). En este caso, cada llamada a iterator() crea un iterador nuevo, por lo que ambos recorridos imprimen los dos elementos.

Ejemplos

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

Resultado

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

El código mostrado y el resultado declarado se verificaron en un entorno aislado mediante el método registrado en la evidencia de verificación de esta versión exacta.

Fuentes