概述

繼承結構

java.util.Iterator<E> << java.util.ListIterator

基本特性

列表迭代器並不持有當前元素的引用，其持有的遊標是位於列表連個元素之間。可以通過呼叫next()或者previous()返回列表中的元素。一個擁有n個元素的列表擁有n+1個遊標位置，示意圖如下：

注意：remove和 set(Object)方法並不是以迭代器的遊標為準，而是以最後一次呼叫迭代器的next()或者previous()方法的返回的元素為準。

基礎方法

boolean hasNext();

當在迭代器正向遍歷仍有可訪問的有效元素時，則返回true

E next();

返回迭代器正向訪問時的下一個元素，並將迭代器遊標進行自增操作。我們可以通過迴圈呼叫這個方法達到遍歷列表中的目的。同時，我們也可以呼叫previous()方法來逆向遍歷列表。當我們交替呼叫next()與previous()時，迭代器將返回相同的元素。

boolean hasPrevious();

當迭代器逆向遍歷仍有可以訪問的有效元素時，則返回true。也就是說，當呼叫方法previous()仍然可以返回一個有效元素時，則返回true。

E previous();
 

返回逆向遍歷列表的下一個元素，並將迭代器的遊標進行自減操作。

int nextIndex();

返回下一次呼叫next()時返回的元素的下標。當列表迭代器到達列表末尾時，則會回列表長度。

int previousIndex();

返回下一次掉呼叫previous()時返回的元素的下標。當列表迭代器到達列表頭部時，則返回-1。

void remove();

刪除最後一次呼叫next()或者previous()返回的元素。呼叫該方法有兩個注意點：

1. 每次呼叫next()或previous()後，僅能呼叫一次本方法；
2. 呼叫本方法前，不可呼叫add(E)方法；

void
 
 set(E e);

替換最後一次呼叫next()或者previous()返回的元素。在呼叫本方法前，不可呼叫add(E)和remove()方法。

void add(E e);

在列表中插入一個新元素。如果next()可以訪問有效元素，則將元素插入到呼叫next()方法返回的元素之前。即：如果previous()可以訪問有效元素，則將元素插入到呼叫previous()方法返回的元素之後。當列表為空時，則插入的元素為列表中唯一的元素。新元素的插入位置為當前迭代器指定的遊標之前，即：插入元素後，呼叫next()返回元素不受影響，而呼叫previous()函式，則會返回剛剛插入的新元素。呼叫這個方法後，會使呼叫nextIndex()或previousIndex()的結構都增大1。插入元素前後的示意圖如下：