int pblHeapEnsureCapacity

( PblHeap* heap, int minCapacity )

Increases the capacity of the heap, if necessary.

Documentation

Increases the capacity of the heap, if necessary.

This function ensures that the heap 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 heap.

Parameters:

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

Returns:

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

Alphabetic index