Trims the capacity of the heap to the heap's current size.

Trims the capacity of the heap to the heap's current size.If the capacity is actually decreased, this function has a time complexity of O(N), with N being the number of elements in the heap.

**Parameters:****heap**- The heap to use**Returns:**- int rc >= 0: The capacity of the heap.

int rc < 0: An error, see pbl_errno:

PBL_ERROR_OUT_OF_MEMORY - Out of memory.

This page was generated with the help of DOC++.