Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

CKTIS / Java

Iterable.forEach: uma ação para cada elemento

Chama `forEach` num objeto `Iterable` para executar uma ação para cada elemento. Se o objeto definir uma ordem de iteração, o método respeita-a, salvo indicação em contrário da classe que implementa a interface.

Versão: Java SE 21

Sintaxe

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

iterable.forEach(action);

Iterable.forEach(Consumer) é um método predefinido da interface java.lang.Iterable<T>, disponível desde Java 8. Podes chamá-lo num objeto cujos elementos podes percorrer, como uma lista. O tipo de retorno é void: o método não devolve uma nova coleção.

O argumento é do tipo java.util.function.Consumer<? super T>. Isto permite passar uma ação que aceita um elemento como T ou como um supertipo de T. O método accept da ação recebe um argumento e não devolve nenhum resultado. Podes passar a ação como expressão lambda, name -> System.out.println(name), ou como referência a um método, System.out::println.

A implementação predefinida comporta-se como um ciclo for melhorado que chama action.accept(element) para cada elemento. Se a ordem de iteração estiver especificada, forEach respeita-a, salvo indicação em contrário da classe que implementa a interface. A ordem de iteração de uma List vai do primeiro ao último elemento. Não pressuponhas uma ordem específica se o objeto não a garantir.

Se a ação lançar uma exceção, o processamento é interrompido e a exceção propaga-se para o código que fez a chamada. Passar null como ação provoca uma NullPointerException. Não alteres a origem dos elementos dentro da ação: nesse caso, o comportamento do método não é especificado, a menos que uma classe que o redefina estabeleça uma política de modificação concorrente.

Exemplos

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

A referência ao método `System.out::println` escreve cada nome numa linha separada. A ordem esperada é `Ada`, `Linus`, `Grace`, tal como na lista.

Lições relacionadas

  • Java · Lição 64 · Básico · Versão: 2

Fontes