Package it.unimi.dsi.fastutil.longs
Class LongArrayFIFOQueue
java.lang.Object
it.unimi.dsi.fastutil.longs.LongArrayFIFOQueue
- All Implemented Interfaces:
LongPriorityQueue
,PriorityQueue<Long>
,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
Modifier and TypeFieldDescriptionstatic final int
The standard initial capacity of a queue. -
Constructor Summary
ConstructorDescriptionCreates a new empty queue with standard initial capacity.LongArrayFIFOQueue
(int capacity) Creates a new empty queue with given capacity. -
Method Summary
Modifier and TypeMethodDescriptionvoid
clear()
Removes all elements from this queue.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
lastLong()
Returns the last element of the queue, that is, the element the would be dequeued last (optional operation).int
size()
Returns the number of elements in this queue.void
trim()
Trims the queue to the smallest possible size.Methods inherited from class java.lang.Object
equals, getClass, hashCode, notify, notifyAll, toString, 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_CAPACITYThe standard initial capacity of a queue.- See Also:
-
-
Constructor Details
-
LongArrayFIFOQueue
public LongArrayFIFOQueue(int capacity) Creates a new empty queue with given capacity.- Parameters:
capacity
- the initial capacity of this queue.- Implementation Notes:
- Because of inner limitations of the JVM, the initial capacity cannot exceed
Arrays.MAX_ARRAY_SIZE
− 1.
-
LongArrayFIFOQueue
public LongArrayFIFOQueue()Creates a new empty queue with standard initial capacity.
-
-
Method Details
-
comparator
Returns the comparator associated with this priority queue, or null if it uses its elements' natural ordering.- Specified by:
comparator
in interfaceLongPriorityQueue
- Specified by:
comparator
in interfacePriorityQueue<Long>
- Returns:
- the comparator associated with this priority queue.
- See Also:
- Implementation Specification:
- This implementation returns
null
(FIFO queues have no comparator).
-
dequeueLong
public long dequeueLong()Description copied from interface:LongPriorityQueue
Dequeues the first element from the queue.- Specified by:
dequeueLong
in interfaceLongPriorityQueue
- 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 interfaceLongPriorityQueue
- Parameters:
x
- the element to enqueue.- See Also:
-
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 interfaceLongPriorityQueue
- 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 interfaceLongPriorityQueue
- Returns:
- the last element.
- See Also:
-
clear
public void clear()Description copied from interface:PriorityQueue
Removes all elements from this queue.- Specified by:
clear
in interfacePriorityQueue<Long>
-
trim
public void trim()Trims the queue to the smallest possible size. -
size
public int size()Description copied from interface:PriorityQueue
Returns the number of elements in this queue.- Specified by:
size
in interfacePriorityQueue<Long>
- Returns:
- the number of elements in this queue.
-