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

CKTIS / Java

Iterable.iterator(): recorridos sucesivos e independientes

`Iterable.iterator()` devuelve un iterador. Admitir recorridos sucesivos no garantiza que los recorridos que se solapan sean independientes ni que cada llamada devuelva un objeto iterador nuevo.

Versión: Java SE 21

Sintaxis

Iterator<T> iterator();

Iterable.iterator() es un método de instancia sin argumentos de java.lang.Iterable<T>. Devuelve un java.util.Iterator<T> para recorrer elementos de tipo T. El Iterable proporciona los elementos que se van a recorrer; el Iterator lleva el control de la posición de un recorrido concreto.

Una implementación puede permitir que se inicie un recorrido cuando termine el anterior sin admitir recorridos que se solapen. Por ejemplo, puede reiniciar y reutilizar el mismo iterador. Si quieres admitir recorridos independientes, como los de los bucles anidados, una forma sencilla es devolver en cada llamada un iterador nuevo con su propia posición, situada al principio. Si los recorridos comparten la posición, avanzar en uno afecta al otro. El contrato general de Iterable no garantiza que se pueda repetir el recorrido: un segundo intento de obtener un iterador de un DirectoryStream lanza IllegalStateException.

Al recorrer los elementos manualmente, comprueba hasNext() antes de llamar a next(). El primer método comprueba si queda algún elemento sin consumirlo; el segundo lo devuelve y avanza la posición. Cuando ya no quedan elementos, next() lanza NoSuchElementException. En un Iterable, el bucle for mejorado llama a iterator() una vez al principio y luego usa hasNext() y next(). Con los arrays, usa índices en su lugar.

Ejemplos

import java.util.Iterator;
import java.util.NoSuchElementException;

public class Main {
    static final class OneToThree implements Iterable<Integer> {
        @Override
        public Iterator<Integer> iterator() {
            return new Iterator<Integer>() {
                private int nextValue = 1;

                @Override
                public boolean hasNext() {
                    return nextValue <= 3;
                }

                @Override
                public Integer next() {
                    if (!hasNext()) {
                        throw new NoSuchElementException();
                    }
                    return nextValue++;
                }
            };
        }
    }

    public static void main(String[] args) {
        Iterable<Integer> numbers = new OneToThree();
        Iterator<Integer> a = numbers.iterator();
        Iterator<Integer> b = numbers.iterator();

        System.out.println("a: " + a.next());
        System.out.println("a: " + a.next());
        System.out.println("b: " + b.next());

        for (int number : numbers) {
            System.out.println("for: " + number);
        }
    }
}

Resultado

a: 1
a: 2
b: 1
for: 1
for: 2
for: 3

`a` devuelve 1 y luego 2, pero `b` sigue empezando en 1. El bucle `for` mejorado obtiene un tercer iterador y muestra los números del 1 al 3.

Lecciones relacionadas

  • Java · Lección 24 · Intermedio · Versión: 2

Fuentes