# binary-heap-plus-rs
Enhancement over Rust's `std::collections::BinaryHeap`.
This version of Binary-heap-plus makes some private functions public.
It supports the following heaps and still maintains backward compatibility.
- Max heap
- Use `BinaryHeap::new()` or `::with_capacity()`
- Min heap
- Use `BinaryHeap::new_min()` or `::with_capacity_min()`
- Heap ordered by closure
- Use `BinaryHeap::new_by()` or `::with_capacity_by()`
- Heap ordered by key generated by closure
- Use `BinaryHeap::new_by_key()` or `::with_capacity_by_key()`
Other notable added methods are:
- `BinaryHeap::from_vec_cmp()` and `BinaryHeap::from_vec()` for more generic construction.
- `.into_iter_sorted()` which is less-surprising version of `.into_iter()`. The implementation is backported from `std`.
- `.replace_cmp()` which replace the comparator of the existing heap.
## MSRV (Minimum Supported Rust Version)
This crate requires Rust 1.32.0 or later.
# Changes
See CHANGELOG.md.
https://github.com/sekineh/binary-heap-plus-rs/blob/master/CHANGELOG.md
# Thanks
- I received many valuable feedback from Pre-RFC thread [1].
- The current design is based on @ExpHP's suggestion that compiles on stable compiler.
- DDOtten, steven099, CAD97, ExpHP, scottmcm, Nemo157 and gnzlbg, thanks for looking into the design!
- @ulysseB sent me a first pull request!
- @inesseq contributed feature `serde1`.
- @davidli2010 contributed comparator update and `unsafe` perf optimazation.
# References
See the following discussions for the background of the crate:
- [1] https://internals.rust-lang.org/t/pre-rfc-binaryheap-flexibility/7482
- https://users.rust-lang.org/t/binaryheap-flexibility-revisited-supporting-other-than-max-heap/17062
- https://users.rust-lang.org/t/binaryheap-flexibility/8766
- https://github.com/rust-lang/rust/issues/38886