java.util
인터페이스 ListIterator<E>

모든 슈퍼 인터페이스:

Iterator <E>

public interface ListIterator<E>
extends Iterator <E>

리스트의 반복자에의해 프로그래머가 몇개의 방향으로 리스트를 더듬어, 반복 처리시로 리스트를 변경해, 반복자의 현재의 위치를 리스트로 취득할 수 있습니다 . ListIterator에는 현재의 요소가 없습니다. 그 커서 위치는 previous() 호출에 의해 리턴된 요소와next() 호출에 의해 리턴된 요소와의 사이에 항상 있습니다. 길이 n 리스트내에는 유효한 인덱스치 n+1가 0 으로부터 n 까지의 사이에 있습니다 (어느 쪽의 값도 포함한다).

 Element(0)   Element(1)   Element(2)   ... Element(n)    ^            ^            ^            ^               ^ Index: 0            1            2            3               n+1
 

remove() 메서드와 set(Object) 메서드는 커서 위치에 따라서는 정의되지 않습니다. 이러한 메서드는 next() 또는 previous() 호출에 의해 리턴된 마지막 요소를 처리하기 위해서 정의됩니다.

이 인터페이스는 Java Collections Framework 멤버입니다.

도입된 버전 :

1.2

관련 항목:

Collection, List, Iterator, Enumeration

메서드 개요

void	add (E o) 지정된 요소를 리스트에 삽입합니다 (임의의 오퍼레이션).
boolean	hasNext () 리스트를 순서 방향으로 더듬었을 때에 리스트 반복자가 또한 요소를 가지고 있는 경우에 true를 리턴합니다.
boolean	hasPrevious () 리스트를 역방향으로 더듬었을 때에 리스트 반복자가 또한 요소를 가지고 있는 경우에 true를 리턴합니다.
E	next () 리스트내의 다음의 요소를 리턴합니다.
int	nextIndex () 다음에 next를 호출했을 때에 돌려주고지게 되는 요소의 인덱스를 리턴합니다.
E	previous () 리스트내의 직전의 요소를 리턴합니다.
int	previousIndex () 다음에 previous를 호출했을 때에 돌려주고지게 되는 요소의 인덱스를 리턴합니다.
void	remove () next 또는 previous에 의해 리턴된 마지막 요소를 리스트로부터 삭제합니다 (임의의 오퍼레이션).
void	set (E o) next 또는 previous에 의해 리턴된 마지막 요소를, 지정된 요소에 치환합니다 (임의의 오퍼레이션).

메서드의 상세

hasNext

boolean hasNext()

리스트를 순서 방향으로 더듬었을 때에 리스트 반복자가 또한 요소를 가지고 있는 경우에 true를 리턴합니다. 즉, next 호출이 예외를 Throw 하는 일 없이 요소를 돌려주는 경우는 true를 리턴합니다.

정의:

인터페이스 Iterator <E > 내의 hasNext

반환값:

리스트를 순서 방향으로 더듬었을 때에 리스트 반복자가 또한 요소를 가지고 있는 경우는 true

next

E  next()

리스트내의 다음의 요소를 리턴합니다. 이 메서드는 리스트를 반복하기 위해서 반복해 호출되는 경우와 전후로 이동하기 위해서 previous 호출과 짜 합쳐지는 경우가 있습니다. next와 previous 호출을 교대로 실시하면, 반복해 같은 요소가 리턴됩니다 .

정의:

인터페이스 Iterator <E > 내의 next

반환값:

리스트의 다음의 요소

예외:

NoSuchElementException - 반복 처리로 다음의 요소가 없는 경우

hasPrevious

boolean hasPrevious()

리스트를 역방향으로 더듬었을 때에 리스트 반복자가 또한 요소를 가지고 있는 경우에 true를 리턴합니다. 즉, previous 호출이 예외를 Throw 하는 일 없이 요소를 돌려주는 경우는 true를 리턴합니다.

반환값:

리스트를 역방향으로 더듬었을 때에 리스트 반복자가 또한 요소를 가지고 있는 경우는 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가 호출할 것에 1회 만 실시할 수 있습니다 . 이 호출은 전회의 next 또는 previous 호출해 이후에 ListIterator.add가 불려가 지 않은 경우에만 실시할 수 있습니다 .

정의:

인터페이스 Iterator <E > 내의 remove

예외:

UnsupportedOperationException - 리스트의 반복자가 remove 오퍼레이션을 지원 하지 않는 경우

IllegalStateException - next 또는 previous 어느쪽이나 불려가 지 않은 경우, 혹은 전회의 next 또는 previous 호출의 나중에 remove 또는 add가 불려 갔을 경우

set

void set(E  o)

next 또는 previous에 의해 리턴된 마지막 요소를, 지정된 요소에 치환합니다 (임의의 오퍼레이션). 이 호출은 전회의 next 또는 previous 호출해 이후에 ListIterator.remove와 ListIterator.add 어느쪽이나 불려가 지 않은 경우에만 실시할 수 있습니다 .

파라미터:

o - next 또는 previous에 의해 리턴된 마지막 요소와 치환되는 요소

예외:

UnsupportedOperationException - 리스트의 반복자가 set 오퍼레이션을 지원 하지 않는 경우

ClassCastException - 지정된 요소의 클래스를 위해서 리스트에 요소를 추가할 수 없는 경우

IllegalArgumentException - 이 요소의 일부의 특성을 위해서 리스트에 요소를 추가할 수 없는 경우

IllegalStateException - next 또는 previous 어느쪽이나 불려가 지 않은 경우, 혹은 전회의 next 또는 previous 호출의 나중에 remove 또는 add가 불려 갔을 경우

add

void add(E  o)

지정된 요소를 리스트에 삽입합니다 (임의의 오퍼레이션). 요소는 next에 의해 리턴된 다음의 요소가 있으면 그 요소의 직전 및 previous에 의해 리턴된 다음의 요소가 있으면 그 요소의 직후에 삽입됩니다. 리스트에 요소가 없는 경우는 새로운 요소가 리스트의 유일한 요소가 됩니다. 새로운 요소는 암묵의 커서의 전에 삽입됩니다. 후속의 next 호출은 영향을 받지 않고, 후속의 previous 호출은 새로운 요소를 리턴합니다. 이 호출은, nextIndex 또는 previousIndex 호출에 의해 리턴된 값을 1 늘립니다.

파라미터:

o - 삽입되는 요소

예외:

UnsupportedOperationException - 리스트 반복자가 add 메서드를 지원 하고 있지 않는 경우

ClassCastException - 지정된 요소의 클래스를 위해서 리스트에 요소를 추가할 수 없는 경우

IllegalArgumentException - 이 요소의 특성이 원인으로 이 리스트에 추가할 수 없는 경우