int pblPriorityQueueEnsureCapacity

( PblPriorityQueue* queue,
  int minCapacity )

Increases the capacity of the priority queue, if necessary.

Documentation

Increases the capacity of the priority queue, if necessary.

This function ensures that the priority queue can hold at least the number of elements specified by the minimum capacity argument.

If the capacity is actually increased, this function has a memory and time complexity of O(N), with N being the new capacity of the queue.

Parameters:

queue - The queue to use
minCapacity - The desired minimum capacity

Returns:

int rc >= 0: OK, the queue capacity is returned.
int rc < 0: An error, see pbl_errno:
PBL_ERROR_OUT_OF_MEMORY - Out of memory.

Alphabetic index