The RQueue reference class

The RQueue reference class implements the data structure queue.


A queue is an ordered list of elements following the First-In-First-Out (FIFO) principle. The enqueue method takes elements and add them to the rear terminal position (right) of the queue, while the dequeue method returns and removes the element in the queue from the front terminal position (left).

The elements in the queue are not necessarily to be of the same type, and they can be any R objects.


An object of class R6ClassGenerator of length 24.

Immutable Methods

The immutable method does not change the instance.


This method returns the leftmost (front) element in the queue. It returns NULL if the queue is empty.

Mutable Methods

The mutable methods change the instance.

enqueue(..., collapse=NULL)

The enqueue method enqueues the elements in ... and collapse into the queue (to the right or rear).

Note that you can input multiple elements.


The dequeue method dequeues (returns and removes) one element (the leftmost or front) fron the queue. It returns NULL if the queue is empty.


For the details about the queue data structure, see Queue at Wikipedia.

See Also

R6DS for the introduction of the reference class and some common methods

  • RQueue
### create a new instance

# to create a new instance of the class
queue <- RQueue$new()

# the previous RQueue instance will be removed if you run
queue <- RQueue$new(0, 1, 2, collapse=list(3, 4))
# the following sentence is equivalent to the above
queue <- RQueue$new(0, 1, 2, 3, 4)
# where the numbers 0, 1, 2, 3, 4 are enqueued into the queue

### enqueue elements

# it can be one single element
# it can be several elements separated by commas
# note the whole list will be one element of the queue
# because it is not passed through the collapse argument
queue$enqueue(list(a=10,b=20), "Hello world!")
# the collapse argument takes a list whose elements will be collapsed
# but the elements' names will not be saved
queue$enqueue(collapse = list(x=100,y=200))
# they can be used together
queue$enqueue("hurrah", collapse = list("RQueue",300))

### dequeue an element

# dequeue only one element at a time
val <- queue$dequeue()
# then we keep dequeuing!
while(!is.null(val)) val <- queue$dequeue()

# }
Documentation reproduced from package R6DS, version 1.2.0, License: GPL-3

Community examples

Looks like there are no examples yet.