| java.util.Iterator<E> |
Known Indirect Subclasses
|
An iterator over a sequence of objects, such as a collection.
If a collection has been changed since the iterator was created, methods next and hasNext() may throw a ConcurrentModificationException. It is not possible to guarantee that this mechanism works in all cases of unsynchronized concurrent modification. It should only be used for debugging purposes. Iterators with this behavior are called fail-fast iterators.
Implementing Iterable and returning an Iterator allows your class to be used as a collection with the enhanced for loop.
| Public Methods | |||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|
|
|
Returns true if there is at least one more element, false otherwise.
|
||||||||||
|
|
Returns the next object and advances the iterator.
|
||||||||||
|
|
Removes the last object returned by
next from the collection.
|
||||||||||
Returns true if there is at least one more element, false otherwise.
Returns the next object and advances the iterator.
| NoSuchElementException | if there are no more elements. |
|---|
Removes the last object returned by next from the collection. This method can only be called once between each call to next.
| UnsupportedOperationException | if removing is not supported by the collection being iterated. |
|---|---|
| IllegalStateException | if next has not been called, or remove has already been called after the last call to next. |