public class BoundedIterator<E> extends Object implements Iterator<E>
The decorated iterator is bounded in the range [offset, offset+max).
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.
|Constructor and Description|
Decorates the specified iterator to return at most the given number of elements, skipping all elements until the iterator reaches the position at
public BoundedIterator(Iterator<? extends E> iterator, long offset, long max)
The iterator is immediately advanced until it reaches the position at
incurring O(n) time.
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
NullPointerException- if iterator is null
IllegalArgumentException- if either offset or max is negative
public void remove()
In 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 an
IllegalStateException if no explicit call to
next() has been made prior
Copyright © 2001–2017 The Apache Software Foundation. All rights reserved.