Package com.github.tommyettinger.ds.support.util

Interface LongIterator

All Superinterfaces:
Iterator<Long>
All Known Implementing Classes:
EditingLongIterator, EnumLongMap.ValueIterator, FilteringLongIterator, IntLongMap.ValueIterator, LimitingLongIterator, LongDeque.LongDequeIterator, LongFloatMap.KeyIterator, LongIntMap.KeyIterator, LongList.LongListIterator, LongLongMap.KeyIterator, LongLongMap.ValueIterator, LongObjectMap.KeyIterator, LongOrderedSet.LongOrderedSetIterator, LongSet.LongSetIterator, ObjectLongMap.ValueIterator, StridingLongIterator
public interface LongIterator extends Iterator<Long>
An Iterator specialized for long values. This iterates over primitive longs using nextLong().
This is roughly equivalent to LongIterator in Java 8, and is present here so environments don't fully support Java 8 APIs (such as RoboVM) can use it.
This interface is closely based on LongIterator in OpenJDK 8. This iterator interface is extremely simple and there's no way to implement it in a way that respects compatibility other than the way OpenJDK 8 does. OpenJDK's license is available here, if it applies at all.

  • Method Summary

    Modifier and Type
    Method
    Description
    default void
    forEachRemaining(com.github.tommyettinger.function.LongConsumer action)
    Performs the given action for each remaining element until all elements have been processed or the action throws an exception.
    default Long
    next()
    long
    nextLong()
    Returns the next long element in the iteration.

    Methods inherited from interface java.util.Iterator

    forEachRemaining, hasNext, remove

  • Method Details

    • nextLong

      long nextLong()
      Returns the next long element in the iteration.
      Returns:
      the next long element in the iteration
      Throws:
      NoSuchElementException - if the iteration has no more elements

    • forEachRemaining

      default void forEachRemaining(com.github.tommyettinger.function.LongConsumer action)
      Performs the given action for each remaining element until all elements have been processed or the action throws an exception. Actions are performed in the order of iteration, if that order is specified. Exceptions thrown by the action are relayed to the caller.
      Parameters:
      action - The action to be performed for each element
      Throws:
      NullPointerException - if the specified action is null
      "Implementation Requirements"

      The default implementation behaves as if: 

      
     while (hasNext())
         action.accept(nextLong());

    • next

      default Long next()
      Specified by:
      next in interface Iterator<Long>
      "Implementation Requirements"
      The default implementation boxes the result of calling nextLong(), and returns that boxed result.