WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / Java

Iterable.iterator(): wiederholte und unabhängige Durchläufe

`Iterable.iterator()` liefert einen Iterator. Sind mehrere Durchläufe nacheinander möglich, bedeutet das weder, dass überlappende Durchläufe unabhängig sind, noch, dass jeder Aufruf ein neues Iteratorobjekt liefert.

Version: Java SE 21

Syntax

Iterator<T> iterator();

Iterable.iterator() ist eine parameterlose Instanzmethode von java.lang.Iterable<T>. Sie gibt einen java.util.Iterator<T> zurück, mit dem sich Elemente vom Typ T durchlaufen lassen. Das Iterable stellt die Elemente bereit; der Iterator verwaltet die Position eines einzelnen Durchlaufs.

Eine Implementierung kann einen neuen Durchlauf nach Abschluss des vorherigen zulassen, ohne überlappende Durchläufe zu unterstützen. Sie kann zum Beispiel denselben Iterator zurücksetzen und wiederverwenden. Wenn du unabhängige Durchläufe ermöglichen willst, etwa in verschachtelten Schleifen, kannst du bei jedem Aufruf einen neuen Iterator mit eigener Position zurückgeben, die auf den Anfang gesetzt ist. Bei einer gemeinsam genutzten Position würde das Vorrücken in einem Durchlauf den anderen beeinflussen. Der allgemeine Vertrag von Iterable garantiert keine Wiederholbarkeit: Beim zweiten Versuch, einen Iterator von einem DirectoryStream abzurufen, wird eine IllegalStateException ausgelöst.

Prüfe beim manuellen Durchlaufen vor next() mit hasNext(), ob noch ein Element vorhanden ist. hasNext() verbraucht kein Element; next() liefert das Element und rückt die Position weiter. Sind keine Elemente mehr übrig, löst next() eine NoSuchElementException aus. Die erweiterte for-Schleife ruft bei einem Iterable einmal zu Beginn iterator() auf und nutzt dann hasNext() und next(). Bei Arrays verwendet sie stattdessen Indizes.

Beispiele

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

Ergebnis

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

`a` liefert zuerst 1 und dann 2, doch `b` beginnt weiterhin bei 1. Die erweiterte `for`-Schleife holt einen dritten Iterator und gibt 1 bis 3 aus.

Zugehörige Lektionen

  • Java · Lektion 24 · Mittlere Stufe · Version: 2

Quellen