Class LongArrayFIFOQueue

java.lang.Object
it.unimi.dsi.fastutil.longs.LongArrayFIFOQueue
All Implemented Interfaces:
LongPriorityQueue, it.unimi.dsi.fastutil.PriorityQueue<Long>, Serializable

public class LongArrayFIFOQueue extends Object implements LongPriorityQueue, Serializable
A type-specific array-based FIFO queue, supporting also deque operations.

Instances of this class represent a FIFO queue using a backing array in a circular way. The array is enlarged and shrunk as needed. You can use the trim() method to reduce its memory usage, if necessary.

This class provides additional methods that implement a deque (double-ended queue).

See Also:
  • Field Summary

    Fields
    Modifier and Type
    Field
    Description
    protected long[]
    The backing array.
    protected int
    The end position in array.
    static final int
    The standard initial capacity of a queue.
    protected int
    The current (cached) length of array.
    protected int
    The start position in array.
  • Constructor Summary

    Constructors
    Constructor
    Description
    Creates a new empty queue with standard initial capacity.
    LongArrayFIFOQueue(int capacity)
    Creates a new empty queue with given capacity.
  • Method Summary

    Modifier and Type
    Method
    Description
    int
    Returns the physical capacity of the queue (internal array).
    void
     
    it.unimi.dsi.fastutil.longs.LongComparator
    Returns the comparator associated with this priority queue, or null if it uses its elements' natural ordering.
    long
    Dequeues the last element from the queue.
    long
    Dequeues the first element from the queue.
    void
    enqueue(long x)
    Enqueues a new element.
    void
    enqueueFirst(long x)
    Enqueues a new element as the first element (in dequeuing order) of the queue.
    long
    Returns the first element of the queue.
    long
    Returns the last element of the queue, that is, the element the would be dequeued last (optional operation).
    int
     
    long[]
     
     
    void
    Trims the queue to the smallest possible size.

    Methods inherited from class java.lang.Object

    clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

    Methods inherited from interface it.unimi.dsi.fastutil.longs.LongPriorityQueue

    dequeue, enqueue, first, last

    Methods inherited from interface it.unimi.dsi.fastutil.PriorityQueue

    changed, isEmpty
  • Field Details

    • INITIAL_CAPACITY

      public static final int INITIAL_CAPACITY
      The standard initial capacity of a queue.
      See Also:
    • array

      protected transient long[] array
      The backing array.
    • length

      protected transient int length
      The current (cached) length of array.
    • start

      protected transient int start
      The start position in array. It is always strictly smaller than length.
    • end

      protected transient int end
      The end position in array. It is always strictly smaller than length. Might be actually smaller than start because array is used cyclically.
  • Constructor Details

    • LongArrayFIFOQueue

      public LongArrayFIFOQueue(int capacity)
      Creates a new empty queue with given capacity.
      Parameters:
      capacity - the initial capacity of this queue.
    • LongArrayFIFOQueue

      public LongArrayFIFOQueue()
      Creates a new empty queue with standard initial capacity.
  • Method Details

    • comparator

      public it.unimi.dsi.fastutil.longs.LongComparator comparator()
      Returns the comparator associated with this priority queue, or null if it uses its elements' natural ordering.
      Specified by:
      comparator in interface LongPriorityQueue
      Specified by:
      comparator in interface it.unimi.dsi.fastutil.PriorityQueue<Long>
      Returns:
      the comparator associated with this priority queue.
      See Also:
      • PriorityQueue.comparator()
    • dequeueLong

      public long dequeueLong()
      Description copied from interface: LongPriorityQueue
      Dequeues the first element from the queue.
      Specified by:
      dequeueLong in interface LongPriorityQueue
      Returns:
      the dequeued element.
      See Also:
    • dequeueLastLong

      public long dequeueLastLong()
      Dequeues the last element from the queue.
      Returns:
      the dequeued element.
      Throws:
      NoSuchElementException - if the queue is empty.
    • enqueue

      public void enqueue(long x)
      Description copied from interface: LongPriorityQueue
      Enqueues a new element.
      Specified by:
      enqueue in interface LongPriorityQueue
      Parameters:
      x - the element to enqueue.
      See Also:
      • PriorityQueue.enqueue(Object)
    • enqueueFirst

      public void enqueueFirst(long x)
      Enqueues a new element as the first element (in dequeuing order) of the queue.
      Parameters:
      x - the element to enqueue.
    • firstLong

      public long firstLong()
      Description copied from interface: LongPriorityQueue
      Returns the first element of the queue.
      Specified by:
      firstLong in interface LongPriorityQueue
      Returns:
      the first element.
      See Also:
    • lastLong

      public long lastLong()
      Description copied from interface: LongPriorityQueue
      Returns the last element of the queue, that is, the element the would be dequeued last (optional operation).

      This default implementation just throws an UnsupportedOperationException.

      Specified by:
      lastLong in interface LongPriorityQueue
      Returns:
      the last element.
      See Also:
    • clear

      public void clear()
      Specified by:
      clear in interface it.unimi.dsi.fastutil.PriorityQueue<Long>
    • trim

      public void trim()
      Trims the queue to the smallest possible size.
    • size

      public int size()
      Specified by:
      size in interface it.unimi.dsi.fastutil.PriorityQueue<Long>
    • capacity

      public int capacity()
      Returns the physical capacity of the queue (internal array).
    • toArray

      public long[] toArray()
      See Also:
    • toString

      public String toString()
      Overrides:
      toString in class Object