CKTIS / Java
Iterable — een contract voor het doorlopen van elementen
java.lang.Iterable<T> maakt het mogelijk een object in een uitgebreide for-lus te gebruiken. De methode iterator() levert een iterator; de standaardmethode forEach() voert een actie uit op opeenvolgende elementen.
Versie: Java SE 21; repository runtime, production runtime not attested
Syntax
public interface Iterable<T>
Iterator<T> iterator()
default void forEach(Consumer<? super T> action)java.lang.Iterable<T> maakt het mogelijk een object in een uitgebreide for-lus te gebruiken; T geeft het elementtype aan. Het is een contract voor het doorlopen van elementen, geen concrete container.
Iterable.iterator() retourneert een Iterator<T>. Maak onderscheid tussen het object dat iteratie mogelijk maakt en de iterator die de voortgang bijhoudt: hasNext() controleert of er een element beschikbaar is en next() haalt het op. Als er geen element beschikbaar is, gooit next() een NoSuchElementException.
Iterable.forEach(Consumer<? super T> action) is een standaardmethode. Deze verwerkt elementen in de iteratievolgorde, als die is vastgelegd. Een uitzondering van de actie stopt de verwerking en wordt doorgegeven aan de aanroeper; een null-actie veroorzaakt een NullPointerException. Wijzig de bron niet in de actie: het gedrag is niet gespecificeerd, tenzij de implementatie daarvoor een passend beleid definieert.
Het voorbeeld implementeert iterator() met de geordende lijst List.of("A", "B") en erft forEach(). Elke aanroep van iterator() maakt hier een nieuwe iterator, zodat beide doorlopen beide elementen afdrukken.
Voorbeelden
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));
}
}Resultaat
loop: A loop: B action: A action: B
De getoonde code en het opgegeven resultaat zijn in een geïsoleerde omgeving geverifieerd met de methode die in het verificatiebewijs voor exact deze versie is vastgelegd.