import * as util from './util'; export default class PriorityQueue { private heap; /** * Creates an empty priority queue. * @class

In a priority queue each element is associated with a "priority", * elements are dequeued in highest-priority-first order (the elements with the * highest priority are dequeued first). Priority Queues are implemented as heaps. * If the inserted elements are custom objects a compare function must be provided, * otherwise the <=, === and >= operators are used to compare object priority.

*
     * function compare(a, b) {
     *  if (a is less than b by some ordering criterion) {
     *     return -1;
     *  } if (a is greater than b by the ordering criterion) {
     *     return 1;
     *  }
     *  // a must be equal to b
     *  return 0;
     * }
     * 
* @constructor * @param {function(Object,Object):number=} compareFunction optional * function used to compare two element priorities. Must return a negative integer, * zero, or a positive integer as the first argument is less than, equal to, * or greater than the second. */ constructor(compareFunction?: util.ICompareFunction); /** * Inserts the specified element into this priority queue. * @param {Object} element the element to insert. * @return {boolean} true if the element was inserted, or false if it is undefined. */ enqueue(element: T): boolean; /** * Inserts the specified element into this priority queue. * @param {Object} element the element to insert. * @return {boolean} true if the element was inserted, or false if it is undefined. */ add(element: T): boolean; /** * Retrieves and removes the highest priority element of this queue. * @return {*} the the highest priority element of this queue, * or undefined if this queue is empty. */ dequeue(): T | undefined; /** * Retrieves, but does not remove, the highest priority element of this queue. * @return {*} the highest priority element of this queue, or undefined if this queue is empty. */ peek(): T | undefined; /** * Returns true if this priority queue contains the specified element. * @param {Object} element element to search for. * @return {boolean} true if this priority queue contains the specified element, * false otherwise. */ contains(element: T): boolean; /** * Checks if this priority queue is empty. * @return {boolean} true if and only if this priority queue contains no items; false * otherwise. */ isEmpty(): boolean; /** * Returns the number of elements in this priority queue. * @return {number} the number of elements in this priority queue. */ size(): number; /** * Removes all of the elements from this priority queue. */ clear(): void; /** * Executes the provided function once for each element present in this queue in * no particular order. * @param {function(Object):*} callback function to execute, it is * invoked with one argument: the element value, to break the iteration you can * optionally return false. */ forEach(callback: util.ILoopFunction): void; }