compact1, compact2, compact3

java.util

Соедините интерфейсом с Iterator <E>

Введите Параметры:

E - тип элементов возвратился этим iterator

Все Известные Подынтерфейсы:

ListIterator <E>, PrimitiveIterator <T>, PrimitiveIterator. OfDouble, PrimitiveIterator. OfInt, PrimitiveIterator. OfLong, XMLEventReader

Все Известные Классы с реализацией:

BeanContextSupport. BCSIterator, EventReaderDelegate, Сканер

public interface Iterator<E>

iterator по набору. Iterator берет место Enumeration в Платформе Наборов Java. Iterators отличаются от перечислений двумя способами:

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

Этот интерфейс является элементом Платформы Наборов Java.

С тех пор:

1.2

См. Также:

Collection, ListIterator, Iterable

Сводка метода

Модификатор и Тип	Метод и Описание
default void	forEachRemaining(Consumer<? super E> action) Выполняет данное действие для каждого остающегося элемента, в порядке, элементы происходят, выполняя итерации, пока все элементы не были обработаны, или действие выдает исключение.
boolean	hasNext() Возвраты true если у итерации есть больше элементов.
E	next() Возвращает следующий элемент в итерации.
default void	remove() Удаляет из базового набора последний элемент, возвращенный этим iterator (дополнительная работа).

Деталь метода

hasNext

boolean hasNext()

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

Возвраты:

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

затем

E next()

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

Возвраты:

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

Броски:

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

удалить

default void remove()

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

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

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

Броски:

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

IllegalStateException - если next метод еще не вызвали, или remove метод уже вызвали после последней возможности к next метод

forEachRemaining

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

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

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

Реализация по умолчанию ведет себя как будто:

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

Параметры:

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

Броски:

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

С тех пор:

1.8