Interface LongIterator

All Superinterfaces:
Iterator<Long>, PrimitiveIterator<Long,LongConsumer>, 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 PrimitiveIterator.OfLong
A type-specific Iterator; provides an additional method to avoid (un)boxing, and the possibility to skip elements.
See Also:
  • Method Details

    • nextLong

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

      @Deprecated default Long next()
      Deprecated.
      Please use the corresponding type-specific method instead.
      Specified by:
      next in interface Iterator<Long>
      Specified by:
      next in interface 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:
    • forEachRemaining

      @Deprecated default void forEachRemaining(Consumer<? super Long> action)
      Deprecated.
      Please use the corresponding type-specific method instead.
      Specified by:
      forEachRemaining in interface Iterator<Long>
      Specified by:
      forEachRemaining in interface 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: