void* pblPriorityQueueRemoveFirst

( PblPriorityQueue* queue,
  int* priority )

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

Documentation

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

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

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