Skip to main content

Class: BinaryHeap<T>

Defined in: src/sdk/utils/datastructures/BinaryHeap.ts:9

A binary min-heap. Each element added to the heap is ordered according to the value of an assigned key relative to the keys of the other elements in the heap. The relative values of element keys are defined by a supplied comparator function. Retrieval of the element with the smallest key (minimum element) is performed in constant time. Removal of the minimum element and insertions are performed in logarithmic time. Additionally, this type of heap supports combined insertion and removal operations (in either order) which are slightly more efficient than chaining the two operations separately.

Type Parameters

Type Parameter
T

Constructors

Constructor

new BinaryHeap<T>(comparator): BinaryHeap<T>

Defined in: src/sdk/utils/datastructures/BinaryHeap.ts:24

Constructor.

Parameters

ParameterTypeDescription
comparator(a, b) => numberThe function that this heap uses to compare the keys of its elements. The function returns 0 if a and b share the same key, a negative number if a has a lower key than b, and a positive number if a has a greater key than b.

Returns

BinaryHeap<T>

Accessors

size

Get Signature

get size(): number

Defined in: src/sdk/utils/datastructures/BinaryHeap.ts:14

The number of elements contained in this heap.

Returns

number

Methods

clear()

clear(): this

Defined in: src/sdk/utils/datastructures/BinaryHeap.ts:95

Removes all elements from this heap.

Returns

this

This heap, after it has been cleared.


findMin()

findMin(): undefined | T

Defined in: src/sdk/utils/datastructures/BinaryHeap.ts:31

Finds the element in this heap with the smallest key.

Returns

undefined | T

The element in this heap with the smallest key, or undefined if this heap is empty.


insert()

insert(element): this

Defined in: src/sdk/utils/datastructures/BinaryHeap.ts:58

Inserts an element into this heap.

Parameters

ParameterTypeDescription
elementTThe element to insert.

Returns

this

This heap, after the element has been inserted.


insertAndRemoveMin()

insertAndRemoveMin(element): T

Defined in: src/sdk/utils/datastructures/BinaryHeap.ts:70

Inserts an element into this heap, then removes the element with the smallest key.

Parameters

ParameterTypeDescription
elementTThe element to insert.

Returns

T

The removed element.


removeMin()

removeMin(): undefined | T

Defined in: src/sdk/utils/datastructures/BinaryHeap.ts:39

Removes and returns the element in this heap with the smallest key.

Returns

undefined | T

The removed element, or undefined if this heap is empty.


removeMinAndInsert()

removeMinAndInsert(element): undefined | T

Defined in: src/sdk/utils/datastructures/BinaryHeap.ts:83

Removes the element in this heap with the smallest key, then inserts a new element.

Parameters

ParameterTypeDescription
elementTThe element to insert.

Returns

undefined | T

The removed element, or undefined if this heap was empty before the new element was inserted.