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