Package it.unimi.dsi.fastutil.longs

Class LongIterators.AbstractIndexBasedListIterator

java.lang.Object
it.unimi.dsi.fastutil.longs.AbstractLongIterator
it.unimi.dsi.fastutil.longs.LongIterators.AbstractIndexBasedIterator
it.unimi.dsi.fastutil.longs.LongIterators.AbstractIndexBasedListIterator
All Implemented Interfaces:
BidirectionalIterator<java.lang.Long>, LongBidirectionalIterator, LongIterator, LongListIterator, ObjectBidirectionalIterator<java.lang.Long>, ObjectIterator<java.lang.Long>, java.util.Iterator<java.lang.Long>, java.util.ListIterator<java.lang.Long>, java.util.PrimitiveIterator<java.lang.Long,​java.util.function.LongConsumer>, java.util.PrimitiveIterator.OfLong
Enclosing class:
LongIterators
public abstract static class LongIterators.AbstractIndexBasedListIterator
extends LongIterators.AbstractIndexBasedIterator
implements LongListIterator
A skeletal implementation for a list-iterator backed by an index-based data store. High performance concrete implementations (like the main ListIterator of ArrayList) generally should avoid using this and just implement the interface directly, but should be decent for less performance critical implementations.

This class is only appropriate for sequences that are at most Integer.MAX_VALUE long. If your backing data store can be bigger then this, consider the equivalently named class in the type specific BigListSpliterators class.

As the abstract methods in this class are used in inner loops, it is generally a good idea to override the class as final as to encourage the JVM to inline them (or alternatively, override the abstract methods as final).

  • Method Details

    • hasPrevious

      public boolean hasPrevious()
      Description copied from interface: BidirectionalIterator
      Returns whether there is a previous element.
      Specified by:
      hasPrevious in interface BidirectionalIterator<java.lang.Long>
      Specified by:
      hasPrevious in interface java.util.ListIterator<java.lang.Long>
      Returns:
      whether there is a previous element.
      See Also:
      ListIterator.hasPrevious()

    • previousLong

      public long previousLong()
      Description copied from interface: LongBidirectionalIterator
      Returns the previous element as a primitive type.
      Specified by:
      previousLong in interface LongBidirectionalIterator
      Returns:
      the previous element in the iteration.
      See Also:
      ListIterator.previous()

    • nextIndex

      public int nextIndex()
      Specified by:
      nextIndex in interface java.util.ListIterator<java.lang.Long>

    • previousIndex

      public int previousIndex()
      Specified by:
      previousIndex in interface java.util.ListIterator<java.lang.Long>

    • add

      public void add​(long k)
      Description copied from interface: LongListIterator
      Inserts the specified element into the list (optional operation).

      This default implementation just throws an UnsupportedOperationException.

      Specified by:
      add in interface LongListIterator
      Parameters:
      k - the element to insert.
      See Also:
      ListIterator.add(Object)

    • set

      public void set​(long k)
      Description copied from interface: LongListIterator
      Replaces the last element returned by LongListIterator.next() or LongListIterator.previous() with the specified element (optional operation).
      Specified by:
      set in interface LongListIterator
      Parameters:
      k - the element used to replace the last element returned.

      This default implementation just throws an UnsupportedOperationException.

      See Also:
      ListIterator.set(Object)

    • back

      public int back​(int n)
      Description copied from interface: LongBidirectionalIterator
      Moves back for the given number of elements.

      The effect of this call is exactly the same as that of calling LongBidirectionalIterator.previous() for n times (possibly stopping if BidirectionalIterator.hasPrevious() becomes false).

      Specified by:
      back in interface LongBidirectionalIterator
      Specified by:
      back in interface ObjectBidirectionalIterator<java.lang.Long>
      Parameters:
      n - the number of elements to skip back.
      Returns:
      the number of elements actually skipped.
      See Also:
      LongBidirectionalIterator.previous()