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