ListIterator (Платформа Java SE 7)

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

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()` с указанным элементом (дополнительная работа).

- Деталь метода
  - 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 - если класс указанного элемента препятствует тому, чтобы это было добавлено к этому списку
    
    IllegalArgumentException - если некоторый аспект указанного элемента препятствует тому, чтобы это было добавлено к этому списку
    
    IllegalStateException - если ни один next ни previous были вызваны, или remove или add были вызваны после последней возможности к next или previous
  - добавить
```
void add(E e)
```
    Вставляет указанный элемент в список (дополнительная работа). Элемент сразу вставляется перед элементом, который был бы возвращен next(), если таковые вообще имеются, и после элемента, который был бы возвращен previous(), если любой. (Если список не содержит элементов, новый элемент становится единственным элементом в списке.) Новый элемент вставляется перед неявным курсором: последующий звонок next было бы незатронуто, и последующий звонок previous возвратил бы новый элемент. (Этот вызов увеличивает одним значение, которое было бы возвращено звонком nextIndex или previousIndex.)
    
    Параметры:
    e - элемент, чтобы вставить
    
    Броски:
    
    UnsupportedOperationException - если add метод не поддерживается этим списком iterator
    
    ClassCastException - если класс указанного элемента препятствует тому, чтобы это было добавлено к этому списку
    
    IllegalArgumentException - если некоторый аспект этого элемента препятствует тому, чтобы это было добавлено к этому списку

Представьте ошибку или функцию
Для дальнейшей ссылки API и документации разработчика, см. Java Документация SE. Та документация содержит более подробные, предназначенные разработчиком описания, с концептуальными краткими обзорами, определениями сроков, обходных решений, и рабочих примеров кода.
Авторское право © 1993, 2011, Oracle и/или его филиалы. Все права защищены.

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

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

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

hasNext

затем

hasPrevious

предыдущий

nextIndex

previousIndex

удалить

набор

добавить