KennisbankExamencentrum
NL · NLNederlands (Nederland)
Taal kiezen13

CKTIS / Java

Iterable.forEach: een actie voor elk element

Roep `forEach` aan op een `Iterable` om voor elk element een actie uit te voeren. Als het object een iteratievolgorde vastlegt, volgt de methode die volgorde, tenzij de klasse die de interface implementeert iets anders bepaalt.

Versie: Java SE 21

Syntax

default void forEach(Consumer<? super T> action)

iterable.forEach(action);

Iterable.forEach(Consumer) is een standaardmethode (default) van de interface java.lang.Iterable<T> en is beschikbaar sinds Java 8. Je roept de methode aan op een object waarvan je de elementen kunt doorlopen, zoals een lijst. Het retourtype is void: de methode geeft geen nieuwe collectie terug.

Het argument heeft het type java.util.function.Consumer<? super T>. Je kunt dus een actie meegeven die een element accepteert als T of als een supertype van T. De methode accept van die actie neemt één argument aan en geeft geen resultaat terug. Je kunt de actie meegeven als lambda, name -> System.out.println(name), of als methodereferentie, System.out::println.

De standaardimplementatie werkt als een uitgebreide for-lus die voor elk element action.accept(element) aanroept. Als de iteratievolgorde vastligt, volgt forEach die volgorde, tenzij de klasse die de interface implementeert iets anders bepaalt. De iteratievolgorde van een List loopt van het eerste naar het laatste element. Ga niet uit van een bepaalde volgorde als het object die niet garandeert.

Als de actie een uitzondering werpt, stopt de verwerking en wordt de uitzondering doorgegeven aan de aanroeper. Geef je null mee als actie, dan krijg je een NullPointerException. Wijzig de bron van de elementen niet binnen de actie: het gedrag van de methode is dan niet gespecificeerd, tenzij een klasse die de methode overschrijft regels voor gelijktijdige wijzigingen vastlegt.

Voorbeelden

import java.util.List;

public class Main {
    public static void main(String[] args) {
        Iterable<String> names = List.of("Ada", "Linus", "Grace");
        names.forEach(System.out::println);
    }
}

Resultaat

Ada
Linus
Grace

De methodereferentie `System.out::println` drukt elke naam op een eigen regel af. De verwachte volgorde is `Ada`, `Linus`, `Grace`, net als in de lijst.

Gerelateerde lessen

  • Java · Les 64 · Basis · Versie: 2

Bronnen