Интерфейс Iterator<E>

public interface Iterator<E>

Итератор по коллекции. Iterator заменяет Enumeration в Java Collections Framework. Итераторы отличаются от перечислений двумя способами:

• Итераторы позволяют вызывающей стороне удалять элементы из базовой коллекции во время итерации с хорошо определённой семантикой.
• Имена методов улучшены.

Этот интерфейс является членом Java Collections Framework.

Методы

hasNext

boolean hasNext()

Возвращает true, если итерация содержит ещё элементы. (Другими словами, возвращает true , если next() вернёт элемент, а не бросит исключение.)

Возвращает:

true , если итерация содержит ещё элементы

next

E next()

Возвращает следующий элемент в итерации.

Возвращает:

следующий элемент в итерации

Бросает:

NoSuchElementException - если в итерации больше нет элементов

remove

default void remove()

Удаляет из базовой коллекции последний элемент, возвращённый этим итератором (необязательная операция). Этот метод может быть вызван только один раз за вызов next(). Поведение итератора не определено, если базовая коллекция изменяется во время итерации каким-либо способом, кроме вызова этого метода.

Требования к реализации:

Стандартная реализация выбрасывает экземпляр UnsupportedOperationException и не выполняет никаких других действий.

Бросает:

UnsupportedOperationException - если операция remove не поддерживается этим итератором

IllegalStateException - если метод next ещё не был вызван или метод remove был уже вызван после последнего вызова метода next

forEachRemaining

default void forEachRemaining(Consumer<? super E> action)

Выполняет заданное действие для каждого оставшегося элемента, пока все элементы не будут обработаны или действие не бросит исключение. Действия выполняются в порядке итерации, если этот порядок задан. Исключения, брошенные действием, передаются вызывающей стороне.

Требования к реализации:

Стандартная реализация ведёт себя так, как если бы:

while (hasNext())
         action.accept(next());

Параметры:

action - действие, которое должно выполняться для каждого элемента

Бросает:

NullPointerException - если указанное действие равно null

С:

1.8