KennisbankExamencentrum
NL · NLNederlands (Nederland)
Taal kiezen13

CKTIS / Java

Iterable.iterator(): opeenvolgende en onafhankelijke doorlopen

`Iterable.iterator()` geeft een iterator terug. Dat je de bron meerdere keren achter elkaar kunt doorlopen, garandeert niet dat overlappende doorlopen onafhankelijk zijn of dat elke aanroep een nieuw iteratorobject teruggeeft.

Versie: Java SE 21

Syntax

Iterator<T> iterator();

Iterable.iterator() is een instantiemethode zonder argumenten van java.lang.Iterable<T>. De methode geeft een java.util.Iterator<T> terug om elementen van het type T te doorlopen. Het Iterable stelt de elementen beschikbaar; de Iterator houdt de positie van één specifieke doorloop bij.

Een implementatie kan een nieuwe doorloop toestaan zodra de vorige is afgerond, zonder overlappende doorlopen te ondersteunen. Ze kan bijvoorbeeld dezelfde iterator terugzetten naar de beginpositie en hergebruiken. Wil je onafhankelijke doorlopen ondersteunen, bijvoorbeeld in geneste lussen, dan kun je bij elke aanroep een nieuwe iterator teruggeven met een eigen positie die op het begin is ingesteld. Als doorlopen dezelfde positie delen, beïnvloedt het opschuiven van de ene doorloop de andere. Het algemene contract van Iterable garandeert niet dat je een doorloop kunt herhalen: bij een tweede poging om een iterator uit een DirectoryStream op te vragen, wordt een IllegalStateException geworpen.

Controleer bij handmatig doorlopen hasNext() voordat je next() aanroept. De eerste methode controleert of er nog een element is zonder het te verbruiken; de tweede geeft het terug en schuift de positie op. Als er geen elementen meer zijn, werpt next() een NoSuchElementException. Bij een Iterable roept de uitgebreide for-lus aan het begin één keer iterator() aan en gebruikt daarna hasNext() en next(). Bij arrays gebruikt de lus in plaats daarvan indexen.

Voorbeelden

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

Resultaat

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

`a` geeft eerst 1 en dan 2 terug, maar `b` begint nog steeds bij 1. De uitgebreide `for`-lus vraagt een derde iterator op en drukt de getallen 1 tot en met 3 af.

Gerelateerde lessen

  • Java · Les 24 · Gemiddeld · Versie: 2

Bronnen