# Queue (abstract data type)

In computer science, a queue is a collection of entities that are maintained in a sequence and can be modified by the addition of entities at one end of the sequence and removal from the other end of the sequence. By convention, the end of the sequence at which elements are added is called the back or rear of the queue and the end at which elements are removed is called the head or front of the queue, analogously to the words used when people line up to wait for goods or services.

Queue
Time complexity in big O notation
Algorithm Space Average Worst case O(n) O(n) O(n) O(n) O(1) O(1) O(1) O(1)

The operation of adding an element to the rear of the queue is known as enqueue, and the operation of removing an element from the front is known as dequeue. Other operations may also be allowed, often including a peek or front operation that returns the value of the next element to be dequeued without dequeuing it.

The operations of a queue make it a first-in-first-out (FIFO) data structure. In a FIFO data structure, the first element added to the queue will be the first one to be removed. This is equivalent to the requirement that once a new element is added, all elements that were added before have to be removed before the new element can be removed. A queue is an example of a linear data structure, or more abstractly a sequential collection. Queues are common in computer programs, where they are implemented as data structures coupled with access routines, as an abstract data structure or in object-oriented languages as classes. Common implementations are circular buffers and linked lists.

Queues provide services in computer science, transport, and operations research where various entities such as data, objects, persons, or events are stored and held to be processed later. In these contexts, the queue performs the function of a buffer. Another usage of queues is in the implementation of breadth-first search.

## Queue implementation

Theoretically, one characteristic of a queue is that it does not have a specific capacity. Regardless of how many elements are already contained, a new element can always be added. It can also be empty, at which point removing an element will be impossible until a new element has been added again.

Fixed length arrays are limited in capacity, but it is not true that items need to be copied towards the head of the queue. The simple trick of turning the array into a closed circle and letting the head and tail drift around endlessly in that circle makes it unnecessary to ever move items stored in the array. If n is the size of the array, then computing indices modulo n will turn the array into a circle. This is still the conceptually simplest way to construct a queue in a high level language, but it does admittedly slow things down a little, because the array indices must be compared to zero and the array size, which is comparable to the time taken to check whether an array index is out of bounds, which some languages do, but this will certainly be the method of choice for a quick and dirty implementation, or for any high level language that does not have pointer syntax. The array size must be declared ahead of time, but some implementations simply double the declared array size when overflow occurs. Most modern languages with objects or pointers can implement or come with libraries for dynamic lists. Such data structures may have not specified fixed capacity limit besides memory constraints. Queue overflow results from trying to add an element onto a full queue and queue underflow happens when trying to remove an element from an empty queue.

A bounded queue is a queue limited to a fixed number of items.[1]

There are several efficient implementations of FIFO queues. An efficient implementation is one that can perform the operations—enqueuing and dequeuing—in O(1) time.

• A doubly linked list has O(1) insertion and deletion at both ends, so it is a natural choice for queues.
• A regular singly linked list only has efficient insertion and deletion at one end. However, a small modification—keeping a pointer to the last node in addition to the first one—will enable it to implement an efficient queue.
• A deque implemented using a modified dynamic array

### Queues and programming languages

Queues may be implemented as a separate data type, or may be considered a special case of a double-ended queue (deque) and not implemented separately. For example, Perl and Ruby allow pushing and popping an array from both ends, so one can use push and unshift functions to enqueue and dequeue a list (or, in reverse, one can use shift and pop), although in some cases these operations are not efficient.

C++'s Standard Template Library provides a "queue" templated class which is restricted to only push/pop operations. Since J2SE5.0, Java's library contains a Queue interface that specifies queue operations; implementing classes include LinkedList and (since J2SE 1.6) ArrayDeque. PHP has an SplQueue class and third party libraries like beanstalk'd and Gearman.

### Examples

A simple queue implemented in Ruby:

class Queue
def initialize
@list = Array.new
end

def enqueue(element)
@list << element
end

def dequeue
@list.shift
end
end


## Purely functional implementation

Queues can also be implemented as a purely functional data structure.[2] Two versions of the implementation exist. The first one, called real-time queue,[3] presented below, allows the queue to be persistent with operations in O(1) worst-case time, but requires lazy lists with memoization. The second one, with no lazy lists nor memoization is presented at the end of the sections. Its amortized time is ${\displaystyle O(1)}$ if the persistency is not used; but its worst-time complexity is ${\displaystyle O(n)}$ where n is the number of elements in the queue.

Let us recall that, for ${\displaystyle l}$ a list, ${\displaystyle |l|}$ denotes its length, that NIL represents an empty list and ${\displaystyle \operatorname {CONS} (h,t)}$ represents the list whose head is h and whose tail is t.

### Real-time queue

The data structure used to implement our queues consists of three linked lists ${\displaystyle (f,r,s)}$ where f is the front of the queue, r is the rear of the queue in reverse order. The invariant of the structure is that s is the rear of f without its ${\displaystyle |r|}$ first elements, that is ${\displaystyle |s|=|f|-|r|}$. The tail of the queue ${\displaystyle (\operatorname {CONS} (x,f),r,s)}$ is then almost ${\displaystyle (f,r,s)}$ and inserting an element x to ${\displaystyle (f,r,s)}$ is almost ${\displaystyle (f,\operatorname {CONS} (x,r),s)}$. It is said almost, because in both of those results, ${\displaystyle |s|=|f|-|r|+1}$. An auxiliary function ${\displaystyle aux}$ must then be called for the invariant to be satisfied. Two cases must be considered, depending on whether ${\displaystyle s}$ is the empty list, in which case ${\displaystyle |r|=|f|+1}$, or not. The formal definition is ${\displaystyle \operatorname {aux} (f,r,\operatorname {Cons} (\_,s))=(f,r,s)}$ and ${\displaystyle \operatorname {aux} (f,r,{\text{NIL}})=(f',{\text{NIL}},f')}$ where ${\displaystyle f'}$ is f followed by r reversed.

Let us call ${\displaystyle \operatorname {reverse} (f,r)}$ the function which returns f followed by r reversed. Let us furthermore assume that ${\displaystyle |r|=|f|+1}$, since it is the case when this function is called. More precisely, we define a lazy function ${\displaystyle \operatorname {rotate} (f,r,a)}$ which takes as input three list such that ${\displaystyle |r|=|f|+1}$, and return the concatenation of f, of r reversed and of a. Then ${\displaystyle \operatorname {reverse} (f,r)=\operatorname {rotate} (f,r,{\text{NIL}})}$. The inductive definition of rotate is ${\displaystyle \operatorname {rotate} ({\text{NIL}},\operatorname {Cons} (y,{\text{NIL}}),a)=\operatorname {Cons} (y,a)}$ and ${\displaystyle \operatorname {rotate} (\operatorname {CONS} (x,f),\operatorname {CONS} (y,r),a)=\operatorname {Cons} (x,\operatorname {rotate} (f,r,\operatorname {CONS} (y,a)))}$. Its running time is ${\displaystyle O(r)}$, but, since lazy evaluation is used, the computation is delayed until the results is forced by the computation.

The list s in the data structure has two purposes. This list serves as a counter for ${\displaystyle |f|-|r|}$, indeed, ${\displaystyle |f|=|r|}$ if and only if s is the empty list. This counter allows us to ensure that the rear is never longer than the front list. Furthermore, using s, which is a tail of f, forces the computation of a part of the (lazy) list f during each tail and insert operation. Therefore, when ${\displaystyle |f|=|r|}$, the list f is totally forced. If it was not the case, the internal representation of f could be some append of append of... of append, and forcing would not be a constant time operation anymore.

### Amortized queue

Note that, without the lazy part of the implementation, the real-time queue would be a non-persistent implementation of queue in ${\displaystyle O(1)}$ amortized time. In this case, the list s can be replaced by the integer ${\displaystyle |f|-|r|}$, and the reverse function would be called when ${\displaystyle s}$ is 0.