public interface ListIterator<E>
ExtendsIterator<E>
Known subtypesForm.TabIterator
An ListIterator is used to sequence over a List of objects. ListIterator can
move backwards or forwards through the list.
Methods
public abstract void add(E object) | Inserts the specified object into the list between next and previous. |
public abstract boolean hasNext() | Returns whether there are more elements to iterate. |
public abstract boolean hasPrevious() | Returns whether there are previous elements to iterate. |
public abstract E next() | Returns the next object in the iteration. |
public abstract int nextIndex() | Returns the index of the next object in the iteration. |
public abstract E previous() | Returns the previous object in the iteration. |
public abstract int previousIndex() | Returns the index of the previous object in the iteration. |
public abstract void remove() | Removes the last object returned by next or previous from the list. |
public abstract void set(E object) | Replaces the last object returned by next or previous with the specified object. |
Method details
add
public abstract void add(E object)Inserts the specified object into the list between
next and
previous. The object inserted will be the previous object.Parameters
objectE- the object to insert.
Throws
UnsupportedOperationException- if adding is not supported by the list being iterated.
ClassCastException- if the class of the object is inappropriate for the list.
IllegalArgumentException- if the object cannot be added to the list.
hasNext
public abstract boolean hasNext()Returns whether there are more elements to iterate.
Returns
true if there are more elements, false otherwise.See also
hasPrevious
public abstract boolean hasPrevious()Returns whether there are previous elements to iterate.
Returns
true if there are previous elements, false
otherwise.See also
next
public abstract E next()Returns the next object in the iteration.
Returns
the next object.
Throws
NoSuchElementException- if there are no more elements.
See also
nextIndex
public abstract int nextIndex()Returns the index of the next object in the iteration.
Returns
the index of the next object, or the size of the list if the
iterator is at the end.
Throws
NoSuchElementException- if there are no more elements.
See also
previous
public abstract E previous()Returns the previous object in the iteration.
Returns
the previous object.
Throws
NoSuchElementException- if there are no previous elements.
See also
previousIndex
public abstract int previousIndex()Returns the index of the previous object in the iteration.
Returns
the index of the previous object, or -1 if the iterator is at the
beginning.
Throws
NoSuchElementException- if there are no previous elements.
See also
remove
public abstract void remove()Removes the last object returned by
next or previous from
the list.Throws
UnsupportedOperationException- if removing is not supported by the list being iterated.
IllegalStateException- if
nextorprevioushave not been called, orremoveoraddhave already been called after the last call tonextorprevious.
set
public abstract void set(E object)Replaces the last object returned by
next or previous
with the specified object.Parameters
objectE- the object to set.
Throws
UnsupportedOperationException- if setting is not supported by the list being iterated
ClassCastException- if the class of the object is inappropriate for the list.
IllegalArgumentException- if the object cannot be added to the list.
IllegalStateException- if
nextorprevioushave not been called, orremoveoraddhave already been called after the last call tonextorprevious.