Build 1.0_r1(from source)

java.util
Interface ListIterator<E>

All Superinterfaces:
Iterator<E>

public interface ListIterator<E>
extends Iterator<E>

An ListIterator is used to sequence over a List of objects. ListIterator can move backwards or forwards through the List.


Method Summary
 void add(E object)
          Inserts the specified object into the list between next and previous.
 boolean hasNext()
          Returns if there are more elements to iterate.
 boolean hasPrevious()
          Returns if there are previous elements to iterate.
 E next()
          Returns the next object in the iteration.
 int nextIndex()
          Returns the index of the next object in the iteration.
 E previous()
          Returns the previous object in the iteration.
 int previousIndex()
          Returns the index of the previous object in the iteration.
 void remove()
          Removes the last object returned by next or previous from the list.
 void set(E object)
          Replaces the last object returned by next or previous with the specified object.
 

Method Detail

add

void add(E object)
Inserts the specified object into the list between next and previous. The object inserted will be the previous object.

Parameters:
object - the object to insert
Throws:
UnsupportedOperationException - when adding is not supported by the list being iterated
ClassCastException - when the class of the object is inappropriate for the list
IllegalArgumentException - when the object cannot be added to the list

hasNext

boolean hasNext()
Returns if there are more elements to iterate.

Specified by:
hasNext in interface Iterator<E>
Returns:
true if there are more elements, false otherwise
See Also:
next()

hasPrevious

boolean hasPrevious()
Returns if there are previous elements to iterate.

Returns:
true if there are previous elements, false otherwise
See Also:
previous()

next

E next()
Returns the next object in the iteration.

Specified by:
next in interface Iterator<E>
Returns:
the next object
Throws:
NoSuchElementException - when there are no more elements
See Also:
hasNext()

nextIndex

int nextIndex()
Returns the index of the next object in the iteration.

Returns:
the index of the next object
Throws:
NoSuchElementException - when there are no more elements
See Also:
next()

previous

E previous()
Returns the previous object in the iteration.

Returns:
the previous object
Throws:
NoSuchElementException - when there are no previous elements
See Also:
hasPrevious()

previousIndex

int previousIndex()
Returns the index of the previous object in the iteration.

Returns:
the index of the previous object
Throws:
NoSuchElementException - when there are no previous elements
See Also:
previous()

remove

void remove()
Removes the last object returned by next or previous from the list.

Specified by:
remove in interface Iterator<E>
Throws:
UnsupportedOperationException - when removing is not supported by the list being iterated
IllegalStateException - when next or previous have not been called, or remove or add have already been called after the last call to next or previous

set

void set(E object)
Replaces the last object returned by next or previous with the specified object.

Parameters:
object - the object to add
Throws:
UnsupportedOperationException - when adding is not supported by the list being iterated
ClassCastException - when the class of the object is inappropriate for the list
IllegalArgumentException - when the object cannot be added to the list
IllegalStateException - when next or previous have not been called, or remove or add have already been called after the last call to next or previous

Build 1.0_r1(from source)

Please submit a feedback, bug or feature