int pblPriorityQueueJoin

( PblPriorityQueue* queue,
  PblPriorityQueue* other )

Joins the two priority queues by moving all elements of the 'other' queue.

Documentation

Joins the two priority queues by moving all elements of the 'other' queue. When this function returns, 'other' will be empty.

This function has a time complexity of O(N), with N being the number of elements in the queue after the join.

Parameters:

queue - The queue to join to
other - The other queue to join

Returns:

int rc >= 0: The size of the queue after the join.
int rc < 0: An error, see pbl_errno:
PBL_ERROR_OUT_OF_MEMORY - Out of memory.

Alphabetic index