window-sort-iterator

Crates.iowindow-sort-iterator
lib.rswindow-sort-iterator
version0.1.0
sourcesrc
created_at2022-06-01 17:52:46.127437
updated_at2022-06-01 17:52:46.127437
descriptionAn iterator adapter that sorts items within a sliding window
homepage
repositoryhttps://github.com/mrd0ll4r/window-sort-iterator
max_upload_size
id598314
size9,676
Leo Balduf (mrd0ll4r)

documentation

README

window-sort-iterator

Crates.io Crates.io Released API docs

An iterator adapter that sorts items within a sliding window.

Implementation

This keeps a BinaryHeap of the items within a sliding window on top of an iterator. The algorithm works like this:

  • As long as the window is not full, requests elements from the underlying iterator and inserts them into the heap.
  • If the window is full, pops the next sorted element from the heap.
  • If the underlying iterator does not produce any more items, drains the remaining elements in-order from the heap.

By default, this uses a max-heap, which results in the highest item being yielded first. You can use a min-heap by wrapping items with std::cmp::Reverse.

Usage

use window_sort_iterator::WindowSortIterExt;

let a = &[4, 2, 3, 1];
let mut it = a.iter().cloned().window_sort(2);
assert_eq!(Some(4), it.next());
assert_eq!(Some(3), it.next());
assert_eq!(Some(2), it.next());
assert_eq!(Some(1), it.next());
assert_eq!(None, it.next());

License

MIT, see LICENSE.

Commit count: 3

cargo fmt