/*
- * Copyright (C) 1995-2007 University of Karlsruhe. All right reserved.
+ * Copyright (C) 1995-2008 University of Karlsruhe. All right reserved.
*
* This file is part of libFirm.
*
* @brief Priority Queue implementation based on the heap datastructure
* @version $Id$
*/
+#include "config.h"
+
#include "array.h"
#include "pqueue.h"
typedef struct _pqueue_el_t {
void *data;
- int key;
+ int priority;
} pqueue_el_t;
struct _pqueue_t {
* Enforces the heap characteristics if the queue
* starting from element at position @p pos.
*/
-static void pqueue_heapify(pqueue *q, int pos) {
- int len = ARR_LEN(q->elems);
+static void pqueue_heapify(pqueue_t *q, unsigned pos) {
+ unsigned len = ARR_LEN(q->elems);
while (pos * 2 < len) {
pqueue_el_t tmp;
- int exchange = pos;
+ unsigned exchange = pos;
- if (q->elems[exchange].key < q->elems[pos * 2].key) {
+ if (q->elems[exchange].priority < q->elems[pos * 2].priority) {
exchange = pos * 2;
}
- if ((pos * 2 + 1) < len && q->elems[exchange].key < q->elems[pos * 2 + 1].key) {
+ if ((pos * 2 + 1) < len
+ && q->elems[exchange].priority < q->elems[pos * 2 + 1].priority) {
exchange = pos * 2 + 1;
}
/**
* Sifts up a newly inserted element at position @p pos.
*/
-static void pqueue_sift_up(pqueue *q, int pos) {
- while(q->elems[pos].key > q->elems[pos / 2].key) {
+static void pqueue_sift_up(pqueue_t *q, unsigned pos) {
+ while(q->elems[pos].priority > q->elems[pos / 2].priority) {
pqueue_el_t tmp;
tmp = q->elems[pos];
}
}
-/**
- * Creates a new priority queue.
- * @return A priority queue of initial length 0.
- */
-pqueue *new_pqueue(void) {
- pqueue *res = xmalloc(sizeof(*res));
+pqueue_t *new_pqueue(void) {
+ pqueue_t *res = XMALLOC(pqueue_t);
res->elems = NEW_ARR_F(pqueue_el_t, 0);
return res;
}
-/**
- * Frees all memory allocated by the priority queue.
- * @param q The priority queue to destroy.
- */
-void del_pqueue(pqueue *q) {
+void del_pqueue(pqueue_t *q) {
DEL_ARR_F(q->elems);
free(q);
}
-/**
- * Inserts a new element into a priority queue.
- * @param q The priority queue the element should be inserted to.
- * @param data The actual data which should be stored in the queue.
- * @param key The priority for the data.
- */
-void pqueue_put(pqueue *q, void *data, int key) {
+void pqueue_put(pqueue_t *q, void *data, int priority) {
pqueue_el_t el;
- el.data = data;
- el.key = key;
+ el.data = data;
+ el.priority = priority;
ARR_APP1(pqueue_el_t, q->elems, el);
pqueue_sift_up(q, ARR_LEN(q->elems) - 1);
}
-/**
- * Returns and removes the first element, ie. that one with the highest priority, from the queue.
- * @param q The priority queue.
- * @return The first element of the queue. Asserts if queue is empty.
- */
-void *pqueue_get(pqueue *q) {
+void *pqueue_pop_front(pqueue_t *q) {
switch(ARR_LEN(q->elems)) {
case 0:
assert(0 && "Attempt to retrieve element from empty priority queue.");
}
}
-/**
- * Get the length of the priority queue.
- * @param q The priority queue.
- * @return The length of the queue.
- */
-int pqueue_length(pqueue *q) {
+int pqueue_length(const pqueue_t *q) {
return ARR_LEN(q->elems);
}
-/**
- * Returns true if queue is empty.
- * @param q The priority queue.
- * @return 1 if the queue is empty, 0 otherwise.
- */
-int pqueue_empty(pqueue *q) {
+int pqueue_empty(const pqueue_t *q) {
return ARR_LEN(q->elems) == 0;
}