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

CKTIS / Java

Iterable.forEach: una acción por cada elemento

Llama a `forEach` sobre un objeto `Iterable` para ejecutar una acción por cada elemento. Si el objeto define un orden de iteración, el método lo respeta, salvo que la clase que implementa la interfaz especifique lo contrario.

Versión: Java SE 21

Sintaxis

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

iterable.forEach(action);

Iterable.forEach(Consumer) es un método predeterminado de la interfaz java.lang.Iterable<T>, disponible desde Java 8. Se llama sobre un objeto cuyos elementos puedes recorrer, como una lista. Su tipo de retorno es void: no devuelve una colección nueva.

El argumento es de tipo java.util.function.Consumer<? super T>. Esto permite pasar una acción que acepta un elemento como T o como un supertipo de T. Su método accept recibe un argumento y no devuelve ningún resultado. Puedes pasar la acción como una lambda, name -> System.out.println(name), o como una referencia a un método, System.out::println.

La implementación predeterminada funciona como un bucle for mejorado que llama a action.accept(element) para cada elemento. Si se especifica el orden de iteración, forEach lo respeta, salvo que la clase que implementa la interfaz especifique lo contrario. El orden de iteración de una List va del primer elemento al último. No des por hecho un orden concreto si el objeto no lo garantiza.

Si la acción lanza una excepción, el procesamiento se detiene y la excepción se propaga al código que realizó la llamada. Pasar null como acción provoca una NullPointerException. No modifiques la fuente de los elementos dentro de la acción: el comportamiento del método no está especificado en ese caso, salvo que una clase que lo sobrescriba establezca una política de modificación concurrente.

Ejemplos

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

Resultado

Ada
Linus
Grace

La referencia a método `System.out::println` imprime cada nombre en una línea. El orden esperado es `Ada`, `Linus`, `Grace`, el mismo que en la lista.

Lecciones relacionadas

  • Java · Lección 64 · Básico · Versión: 2

Fuentes