Interface RangeIterator<E>

All Superinterfaces:
Iterator<E>

public interface RangeIterator<E> extends Iterator<E>
Extends Iterator<E> with the skip, getSize and getPosition methods.
  • Method Summary

    Modifier and Type
    Method
    Description
    long
    Returns the current position within the iterator.
    long
    Returns the number of elements in the iterator.
    void
    skip(long skipNum)
    Skip a number of elements in the iterator.

    Methods inherited from interface java.util.Iterator

    forEachRemaining, hasNext, next, remove
  • Method Details

    • skip

      void skip(long skipNum)
      Skip a number of elements in the iterator.
      Parameters:
      skipNum - the non-negative number of elements to skip
      Throws:
      NoSuchElementException - if skipped past the last element in the iterator.
    • getSize

      long getSize()
      Returns the number of elements in the iterator. If this information is unavailable, returns -1.
      Returns:
      a long
    • getPosition

      long getPosition()
      Returns the current position within the iterator. The number returned is the 0-based index of the next element in the iterator, i.e. the one that will be returned on the subsequent next call.

      Note that this method does not check if there is a next element, i.e. an empty iterator will always return 0.

      Returns:
      a long