Class EmptyListIterator<E>
java.lang.Object
org.apache.commons.collections4.iterators.EmptyListIterator<E>
- Type Parameters:
- E- the type of elements returned by this iterator.
- All Implemented Interfaces:
- Iterator<E>,- ListIterator<E>,- OrderedIterator<E>,- ResettableIterator<E>,- ResettableListIterator<E>
Provides an implementation of an empty list iterator.
 
 This class provides an implementation of an empty list iterator. This class
 provides for binary compatibility between Commons Collections 2.1.1 and 3.1
 due to issues with IteratorUtils.
 
- Since:
- 2.1.1 and 3.1
- 
Field SummaryFieldsModifier and TypeFieldDescriptionstatic final ListIteratorSingleton instance of the iterator.static final ResettableListIteratorSingleton instance of the iterator.
- 
Constructor SummaryConstructors
- 
Method SummaryModifier and TypeMethodDescriptionvoidDeprecated.Will be removed in 5.0 without replacement.static <E> ListIterator<E> Gets a typed instance of the iterator.booleanhasNext()Always returns false, this iterator contains no elements.booleanAlways returns false, this iterator contains no elements.next()Always throws IllegalStateException, this iterator contains no elements.intAlways returns 0, this iterator contains no elements.previous()Always throws IllegalStateException, this iterator contains no elements.intAlways returns -1, this iterator contains no elements.voidremove()Always throws IllegalStateException, this iterator contains no elements.voidreset()Resets the iterator back to the position at which the iterator was created.static <E> ResettableListIterator<E> Gets a typed instance of the iterator.voidAlways throws IllegalStateException, this iterator contains no elements.Methods inherited from class java.lang.Objectclone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, waitMethods inherited from interface java.util.IteratorforEachRemainingMethods inherited from interface java.util.ListIteratoradd, hasNext, hasPrevious, next, nextIndex, previous, previousIndex, remove, setMethods inherited from interface org.apache.commons.collections4.OrderedIteratorhasPrevious, previousMethods inherited from interface org.apache.commons.collections4.ResettableIteratorreset
- 
Field Details- 
RESETTABLE_INSTANCESingleton instance of the iterator.- Since:
- 3.1
 
- 
INSTANCE
 
- 
- 
Constructor Details- 
EmptyListIteratorprotected EmptyListIterator()Constructs a new instance.
 
- 
- 
Method Details- 
emptyListIteratorGets a typed instance of the iterator.- Type Parameters:
- E- the element type
- Returns:
- ListIterator<E>
 
- 
resettableEmptyListIteratorGets a typed instance of the iterator.- Type Parameters:
- E- the element type
- Returns:
- ResettableListIterator<E>
 
- 
addDeprecated.Will be removed in 5.0 without replacement.Always throws UnsupportedOperationException.- Parameters:
- ignored- ignore.
- Throws:
- UnsupportedOperationException- Always thrown.
 
- 
hasNext
- 
hasPreviouspublic boolean hasPrevious()Always returns false, this iterator contains no elements.- Returns:
- Always false.
 
- 
nextAlways throws IllegalStateException, this iterator contains no elements.- Specified by:
- nextin interface- Iterator<E>
- Returns:
- Always throws IllegalStateException.
- Throws:
- IllegalStateException- Always thrown.
 
- 
nextIndexpublic int nextIndex()Always returns 0, this iterator contains no elements.- Returns:
- Always returns 0.
 
- 
previousAlways throws IllegalStateException, this iterator contains no elements.- Returns:
- Always throws IllegalStateException.
- Throws:
- IllegalStateException- Always thrown.
 
- 
previousIndexpublic int previousIndex()Always returns -1, this iterator contains no elements.- Returns:
- Always returns -1.
 
- 
removepublic void remove()Always throws IllegalStateException, this iterator contains no elements.- Specified by:
- removein interface- Iterator<E>
- Throws:
- IllegalStateException- Always thrown.
 
- 
resetpublic void reset()Description copied from interface:ResettableIteratorResets the iterator back to the position at which the iterator was created.- Specified by:
- resetin interface- ResettableIterator<E>
 
- 
setAlways throws IllegalStateException, this iterator contains no elements.- Parameters:
- ignored- ignored.
- Throws:
- IllegalStateException- Always thrown.
 
 
-