int pblPriorityQueueChangePriorityFirst

( PblPriorityQueue* queue,
  int priority )

Changes the priority of the first element of the priority queue, maintaining the heap condition of the queue.

Documentation

Changes the priority of the first element of 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 - The new priority of the first element

Returns:

int rc >= 0: The index of the first element after the priority change.
int rc < 0: An error see pbl_errno:
PBL_ERROR_OUT_OF_BOUNDS - The queue is empty.

Alphabetic index