void* pblPriorityQueueRemoveLast

( PblPriorityQueue* queue,
  int* priority )

Removes the last element from the priority queue, maintaining the heap condition of the queue.

Documentation

Removes the last element from the priority queue, maintaining the heap condition of the queue.

Note: The last element is not guaranteed to be the element with the lowest priority!

This function has a time complexity of O(1).

Parameters:

queue - The queue to use
priority - On return contains the priority of the element removed

Returns:

void* retptr != (void*)-1: The element removed.
void* retptr == (void*)-1: An error see pbl_errno:
PBL_ERROR_OUT_OF_BOUNDS - The queue is empty.

Alphabetic index