Class BoundedIterator<E>
- Type Parameters:
- E- the type of elements returned by this iterator.
- All Implemented Interfaces:
- Iterator<E>
 The decorated iterator is bounded in the range [offset, offset+max).
 The offset corresponds to the position of the first element to
 be returned from the decorated iterator, and max is the maximum
 number of elements to be returned at most.
 
In case an offset parameter other than 0 is provided, the decorated iterator is immediately advanced to this position, skipping all elements before that position.
- Since:
- 4.1
- 
Constructor SummaryConstructorsConstructorDescriptionBoundedIterator(Iterator<? extends E> iterator, long offset, long max) Decorates the specified iterator to return at most the given number of elements, skipping all elements until the iterator reaches the position atoffset.
- 
Method SummaryMethods inherited from class java.lang.Objectclone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, waitMethods inherited from interface java.util.IteratorforEachRemaining
- 
Constructor Details- 
BoundedIteratorDecorates the specified iterator to return at most the given number of elements, skipping all elements until the iterator reaches the position atoffset.The iterator is immediately advanced until it reaches the position at offset, incurring O(n) time.- Parameters:
- iterator- the iterator to be decorated
- offset- the index of the first element of the decorated iterator to return
- max- the maximum number of elements of the decorated iterator to return
- Throws:
- NullPointerException- if iterator is null
- IllegalArgumentException- if either offset or max is negative
 
 
- 
- 
Method Details- 
hasNext
- 
next
- 
removeIn case an offset other than 0 was specified, the underlying iterator will be advanced to this position upon creation. A call to remove()will still result in anIllegalStateExceptionif no explicit call tonext()has been made prior to callingremove().
 
-