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.