База знанияИзпитен център
BGБългарски
Избери език13

CKTIS / Java

Iterable.forEach: действие за всеки елемент

Извикай `forEach` върху обект `Iterable`, за да изпълниш действие за всеки елемент. Ако обектът задава ред на обхождане, методът го спазва, освен ако класът, който реализира интерфейса, не указва друго.

Версия: Java SE 21

Синтаксис

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

iterable.forEach(action);

Iterable.forEach(Consumer) е метод по подразбиране в интерфейса java.lang.Iterable<T>, наличен от Java 8. Извикваш го върху обект, чиито елементи могат да се обхождат, например списък. Връщаният тип е void: методът не връща нова колекция.

Аргументът е от тип java.util.function.Consumer<? super T>. Така можеш да подадеш действие, което приема елемент като T или като надтип на T. Методът accept на действието приема един аргумент и не връща резултат. Можеш да подадеш действието като ламбда израз name -> System.out.println(name) или като референция към метод System.out::println.

Реализацията по подразбиране работи като разширен цикъл for, който извиква action.accept(element) за всеки елемент. Ако е зададен ред на обхождане, forEach го спазва, освен ако класът, който реализира интерфейса, не указва друго. Редът на обхождане при List е от първия до последния елемент. Не разчитай на конкретен ред, ако обектът не го гарантира.

Ако действието хвърли изключение, обработката спира и изключението се предава към извикващия код. Подаването на null като действие води до NullPointerException. Не променяй източника на елементите в самото действие: тогава поведението на метода не е специфицирано, освен ако клас, който го предефинира, не задава правила за едновременни промени.

Примери

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

Резултат

Ada
Linus
Grace

Референцията към метод `System.out::println` отпечатва всяко име на отделен ред. Очакваният ред е `Ada`, `Linus`, `Grace`, както в списъка.

Свързани уроци

  • Java · Урок 64 · Начално · Версия: 2

Източници