#binary-heap #heap #binary #priority-queue #queue #priority

mut-binary-heap

Enhanced version of std::collections::BinaryHeap that supports increase and decrease key, max, min, and custom-order heaps

1 unstable release

0.1.0 Mar 20, 2023

#2108 in Data structures

Download history 14/week @ 2024-01-01 13/week @ 2024-02-12 10/week @ 2024-02-19 16/week @ 2024-02-26 9/week @ 2024-03-04 15/week @ 2024-03-11 10/week @ 2024-03-18 34/week @ 2024-04-01

61 downloads per month

MIT/Apache

105KB
1.5K SLoC

mut-binary-heap

Crates.io Documentation Codecov Dependency status

This create provides a binary heap implementation that stores key-value pairs. The main advantage of that is that unlike with an implementation like std::collections::BinaryHeap checking if any given key exist is O(1) instead of O(n). Same for getting the value for a given key. This allows for cheap modification of values within the binary heap. Updating a value is O(log n) iff you have direct access to the value. For a binary heap that does not store key-value pairs update operations would be O(n) because they first have to find the value to update. The disadvantage is the additional storage space required to store a hash map that provides indices into the heap for each key.

Enhancement over Rust's std::collections::BinaryHeap.

MSRV (Minimum Supported Rust Version)

The minimum supported Rust version is 1.56.0.

Changes

This crate is based on binary-heap-plus which is itself a based on the standard library's implementation of BinaryHeap.

Version 0.1.0 provides a thorough refactor to allow storage of key-value pairs as well as retrieval and modification of values.

For more see: CHANGELOG.md.

License

Licensed under either of

at your option.

Contribution

Unless you explicitly state otherwise, any contribution intentionally submitted for inclusion in the work by you, as defined in the Apache-2.0 license, shall be dual licensed as above, without any additional terms or conditions.

Dependencies

~195KB