compact1, compact2, compact3

java.util

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

Все Суперинтерфейсы:

Iterator <E>

public interface ListIterator<E>
extends Iterator<E>

iterator для списков, который позволяет программисту пересекать список в любом направлении, измените список во время итерации, и получите текущую позицию iterator в списке. A ListIterator не имеет никакого текущего элемента; его позиция курсора всегда находится между элементом, который был бы возвращен звонком previous() и элемент, который был бы возвращен звонком next(). iterator для списка длины n имеет n+1 возможные позиции курсора, как иллюстрировано каре (^) ниже:

                      Element(0)   Element(1)   Element(2)   ... Element(n-1)
 cursor positions:  ^            ^            ^            ^                  ^
 

Отметьте что remove() и set(Object) методы не определяются с точки зрения позиции курсора; они определяются, чтобы работать на последнем элементе, возвращенном звонком next() или previous().

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

С тех пор:

1.2

См. Также:

Collection, List, Iterator, Enumeration, List.listIterator()

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

Модификатор и Тип	Метод и Описание
void	add(E e) Вставляет указанный элемент в список (дополнительная работа).
boolean	hasNext() Возвраты true если у этого списка iterator есть больше элементов, пересекая список в прямом направлении.
boolean	hasPrevious() Возвраты true если у этого списка iterator есть больше элементов, пересекая список в обратном направлении.
E	next() Возвращает следующий элемент в списке и совершенствует позицию курсора.
int	nextIndex() Возвращает индексирование элемента, который был бы возвращен последующим звонком next().
E	previous() Возвращает предыдущий элемент в списке и перемещает позицию курсора назад.
int	previousIndex() Возвращает индексирование элемента, который был бы возвращен последующим звонком previous().
void	remove() Удаляет из списка последний элемент, который был возвращен next() или previous() (дополнительная работа).
void	set(E e) Заменяет последний элемент, возвращенный next() или previous() с указанным элементом (дополнительная работа).

Методы, наследованные от интерфейса java.util. Iterator

forEachRemaining

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

hasNext

boolean hasNext()

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

Определенный:

hasNext в интерфейсе Iterator<E>

Возвраты:

true если у списка iterator есть больше элементов, пересекая список в прямом направлении

затем

E next()

Возвращает следующий элемент в списке и совершенствует позицию курсора. Этот метод можно вызвать неоднократно, чтобы выполнить итерации через список, или смешан со звонками previous() пойти назад и вперед. (Отметьте тот переменные звонки next и previous будет неоднократно возвращать тот же самый элемент.)

Определенный:

next в интерфейсе Iterator<E>

Возвраты:

следующий элемент в списке

Броски:

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

hasPrevious

boolean hasPrevious()

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

Возвраты:

true если у списка iterator есть больше элементов, пересекая список в обратном направлении

предыдущий

E previous()

Возвращает предыдущий элемент в списке и перемещает позицию курсора назад. Этот метод можно вызвать неоднократно, чтобы выполнить итерации через список назад, или смешан со звонками next() пойти назад и вперед. (Отметьте тот переменные звонки next и previous будет неоднократно возвращать тот же самый элемент.)

Возвраты:

предыдущий элемент в списке

Броски:

NoSuchElementException - если у итерации нет никакого предыдущего элемента

nextIndex

int nextIndex()

Возвращает индексирование элемента, который был бы возвращен последующим звонком next(). (Возвраты перечисляют размер, если список iterator в конце списка.)

Возвраты:

индексирование элемента, который был бы возвращен последующим звонком next, или размер списка, если список iterator в конце списка

previousIndex

int previousIndex()

Возвращает индексирование элемента, который был бы возвращен последующим звонком previous(). (Возвраты-1, если список iterator в начале списка.)

Возвраты:

индексирование элемента, который был бы возвращен последующим звонком previous, или-1, если список iterator в начале списка

удалить

void remove()

Удаляет из списка последний элемент, который был возвращен next() или previous() (дополнительная работа). Этот вызов может только быть выполнен однажды на звонок next или previous. Это может быть сделано только если add(E) не был вызван после последней возможности к next или previous.

Определенный:

remove в интерфейсе Iterator<E>

Броски:

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

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

набор

void set(E e)

Заменяет последний элемент, возвращенный next() или previous() с указанным элементом (дополнительная работа). Этот вызов может быть выполнен только если ни один remove() ни add(E) были вызваны после последней возможности к next или previous.

Параметры:

e - элемент, которым можно заменить последний элемент, возвращенный next или previous

Броски:

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

ClassCastException - если class указанного элемента препятствует тому, чтобы это было добавлено к этому списку

IllegalArgumentException - если некоторый аспект указанного элемента препятствует тому, чтобы это было добавлено к этому списку

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

добавить

void add(E e)

Вставляет указанный элемент в список (дополнительная работа). Элемент сразу вставляется перед элементом, который был бы возвращен next(), если таковые вообще имеются, и после элемента, который был бы возвращен previous(), если любой. (Если список не содержит элементов, новый элемент становится единственным элементом в списке.) Новый элемент вставляется перед неявным курсором: последующий звонок next было бы незатронуто, и последующий звонок previous возвратил бы новый элемент. (Этот вызов увеличивает одним значение, которое было бы возвращено звонком nextIndex или previousIndex.)

Параметры:

e - элемент, чтобы вставить

Броски:

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

ClassCastException - если class указанного элемента препятствует тому, чтобы это было добавлено к этому списку

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