compact1, compact2, compact3

java.util

Interface ListIterator<E>

All Superinterfaces:

Iterator

public interface ListIterator<E>
extends Iterator<E>

一个列表的迭代器，允许程序员在两个方向遍历列表，在迭代过程中修改列表，并获得在列表中的迭代器的当前位置。一个 ListIterator没有电流元；其光标位置总是存在的元素，将由一个叫 previous()和元素，将返回被调用的返回 next()之间。一个列表的长度 n迭代器有 n+1可能的光标位置，如图所示的照料者（ ^）如下：

元素（0）元素（1）元素（2）…元（n-1）光标的位置：

注意 remove()和 set(Object)方法不在光标位置的定义；他们的定义上的最后一个元素的操作被调用的 next()或 previous()

该接口的 Java Collections Framework成员。

返回。

从以下版本开始：

一点二

另请参见：

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

方法摘要

Modifier and Type	Method and Description
void	add(E e) 将指定的元素插入到列表中（可选操作）。
boolean	hasNext() 返回 true如果列表迭代器具有更多的元素时，正向遍历列表。
boolean	hasPrevious() 返回 true如果列表迭代器具有更多的元素时，逆向遍历列表。
E	next() 返回列表中的下一个元素，并推进光标位置。
int	nextIndex() 返回的元素，将返回的后续调用 next()指数。
E	previous() 返回列表中的前一个元素，并向后移动光标位置。
int	previousIndex() 返回的元素，将返回的后续调用 previous()指数。
void	remove() 从列表中删除最后一个元素是由 next()或 previous()返回（可选操作）。
void	set(E e) 取代过去的元素返回 next()或 previous()与指定的元素（可选操作）。

Methods inherited from interface java.util.Iterator

forEachRemaining

方法详细信息

hasNext

boolean hasNext()

返回 true如果列表迭代器具有更多的元素时，正向遍历列表。（换句话说，如果返回 true next()会返回一个元素而不是抛出一个例外。）

Specified by:

hasNext 接口 Iterator<E>

结果

true如果列表迭代器具有更多的元素时，正向遍历列表

next

E next()

返回列表中的下一个元素，并推进光标位置。这种方法可以重复调用遍历列表，或混合调用 previous()来回要走。（注意交替调用 next和 previous将返回相同的元素重复。）

Specified by:

next 接口 Iterator<E>

结果

列表中的下一个元素

异常

NoSuchElementException -如果没有下一个元素的迭代

hasPrevious

boolean hasPrevious()

返回 true如果列表迭代器具有更多的元素时，逆向遍历列表。（换句话说，如果返回 true previous()会返回一个元素而不是抛出一个例外。）

结果

true如果列表迭代器具有更多的元素时，逆向遍历列表

previous

E previous()

返回列表中的前一个元素，并向后移动光标位置。这种方法可以重复调用遍历列表时，或在调用 next()来回要走。（注意交替调用 next和 previous将返回相同的元素重复。）

结果

列表中的前一个元素

异常

NoSuchElementException如果迭代中没有前一个元素

nextIndex

int nextIndex()

返回的元素，将返回的后续调用 next()指数。如果列表迭代器在列表的结尾，则返回列表大小。）

结果

的元素会被再次调用 next返回索引，或列表的大小如果列表迭代器是列表的末尾

previousIndex

int previousIndex()

返回的元素会被再次调用 previous()返回索引。（返回1如果列表迭代器是在列表的开始）

结果

的元素会被再次调用 previous返回索引，或1如果列表迭代器是在列表的开始

remove

void remove()

从列表中删除最后一个元素是由 next()或 previous()返回（可选操作）。这叫只能每打电话 next或 previous曾经。可只有 add(E)尚未 next或 previous过去之后调用了。

Specified by:

remove 接口 Iterator<E>

异常

UnsupportedOperationException -如果 remove操作不通过列表迭代器支持

IllegalStateException -如果没有 next也 previous一直叫，或 remove或 add已经 next或 previous过去之后调用

set

void set(E e)

取代过去的元素返回 next()或 previous()与指定的元素（可选操作）。这个电话可以只有不 remove()也 add(E)已经 next或 previous过去之后调用了。

参数

e -该元素取代的最后一个元素返回 next或 previous

异常

UnsupportedOperationException -如果 set操作不通过列表迭代器支持

ClassCastException -如果指定元素类型阻止其加入列表

IllegalArgumentException -如果指定元素的某些方面阻止其加入列表

IllegalStateException -如果没有 next也 previous一直叫，或 remove或 add已经 next或 previous过去之后调用

add

void add(E e)

将指定的元素插入到列表中（可选操作）。元素插入的元素，将立即返回 next()，之前的任何元素，并将返回的 previous()后，如果任何。（如果列表中没有的元素，新的元素也在名单上。单一元素）新的元素插入在隐式游标：随后调用 next将不受影响，和随后的电话 previous会返回新的元素。（这叫增加一个值，可以通过调用 nextIndex或 previousIndex。返回）

参数

e -元素的插入

异常

UnsupportedOperationException -如果 add方法不通过列表迭代器支持

ClassCastException -如果指定元素类型阻止其加入列表

IllegalArgumentException -如果该元素的某些方面不允许它被添加到列表