Interface LongIterator

All Superinterfaces:
java.util.Iterator<java.lang.Long>, java.util.PrimitiveIterator<java.lang.Long,​java.util.function.LongConsumer>, java.util.PrimitiveIterator.OfLong
All Known Subinterfaces:
LongBidirectionalIterator, LongBigListIterator, LongListIterator
All Known Implementing Classes:
AbstractLongBidirectionalIterator, AbstractLongBigListIterator, AbstractLongIterator, AbstractLongListIterator, LongBigListIterators.AbstractIndexBasedBigIterator, LongBigListIterators.AbstractIndexBasedBigListIterator, LongBigListIterators.BigListIteratorListIterator, LongBigListIterators.EmptyBigListIterator, LongBigListIterators.UnmodifiableBigListIterator, LongIterators.AbstractIndexBasedIterator, LongIterators.AbstractIndexBasedListIterator, LongIterators.EmptyIterator, LongIterators.UnmodifiableBidirectionalIterator, LongIterators.UnmodifiableIterator, LongIterators.UnmodifiableListIterator

public interface LongIterator
extends java.util.PrimitiveIterator.OfLong
A type-specific Iterator; provides an additional method to avoid (un)boxing, and the possibility to skip elements.
See Also:
Iterator
  • Nested Class Summary

    Nested classes/interfaces inherited from interface java.util.PrimitiveIterator

    java.util.PrimitiveIterator.OfDouble, java.util.PrimitiveIterator.OfInt, java.util.PrimitiveIterator.OfLong
  • Method Summary

    Modifier and Type Method Description
    default void forEachRemaining​(LongConsumer action)
    Performs the given action for each remaining element until all elements have been processed or the action throws an exception.
    default void forEachRemaining​(java.util.function.Consumer<? super java.lang.Long> action)
    Deprecated.
    Please use the corresponding type-specific method instead.
    default java.lang.Long next()
    Deprecated.
    Please use the corresponding type-specific method instead.
    long nextLong()
    Returns the next element as a primitive type.
    default int skip​(int n)
    Skips the given number of elements.

    Methods inherited from interface java.util.Iterator

    hasNext, remove

    Methods inherited from interface java.util.PrimitiveIterator.OfLong

    forEachRemaining
  • Method Details

    • nextLong

      long nextLong()
      Returns the next element as a primitive type.
      Specified by:
      nextLong in interface java.util.PrimitiveIterator.OfLong
      Returns:
      the next element in the iteration.
      See Also:
      Iterator.next()
    • next

      @Deprecated default java.lang.Long next()
      Deprecated.
      Please use the corresponding type-specific method instead.
      Specified by:
      next in interface java.util.Iterator<java.lang.Long>
      Specified by:
      next in interface java.util.PrimitiveIterator.OfLong
    • forEachRemaining

      default void forEachRemaining​(LongConsumer action)
      Performs the given action for each remaining element until all elements have been processed or the action throws an exception.

      WARNING: Overriding this method is almost always a mistake, as this overload only exists to disambiguate. Instead, override the forEachRemaining() overload that uses the JDK's primitive consumer type (e.g. IntConsumer).

      If Java supported final default methods, this would be one, but sadly it does not.

      If you checked and are overriding the version with java.util.function.XConsumer, and still see this warning, then your IDE is incorrectly conflating this method with the proper method to override, and you can safely ignore this message.

      Parameters:
      action - the action to be performed for each element.
      Since:
      8.5.0
      See Also:
      Iterator.forEachRemaining(java.util.function.Consumer)
    • forEachRemaining

      @Deprecated default void forEachRemaining​(java.util.function.Consumer<? super java.lang.Long> action)
      Deprecated.
      Please use the corresponding type-specific method instead.
      Specified by:
      forEachRemaining in interface java.util.Iterator<java.lang.Long>
      Specified by:
      forEachRemaining in interface java.util.PrimitiveIterator.OfLong
    • skip

      default int skip​(int n)
      Skips the given number of elements.

      The effect of this call is exactly the same as that of calling next() for n times (possibly stopping if Iterator.hasNext() becomes false).

      Parameters:
      n - the number of elements to skip.
      Returns:
      the number of elements actually skipped.
      See Also:
      Iterator.next()