#sorting #sets #collection #elements #vector #maintain #unique

sorted-vec

Create and maintain sorted vectors and vector-backed sets

21 releases

0.8.6 Jan 25, 2025
0.8.5 Oct 24, 2024
0.8.3 Sep 28, 2023
0.8.2 Jan 4, 2023
0.3.1 Mar 19, 2019

#70 in Data structures

Download history 20183/week @ 2024-10-22 18147/week @ 2024-10-29 17240/week @ 2024-11-05 15796/week @ 2024-11-12 17615/week @ 2024-11-19 20540/week @ 2024-11-26 24943/week @ 2024-12-03 26961/week @ 2024-12-10 22489/week @ 2024-12-17 10343/week @ 2024-12-24 14774/week @ 2024-12-31 27345/week @ 2025-01-07 26370/week @ 2025-01-14 25794/week @ 2025-01-21 27299/week @ 2025-01-28 27757/week @ 2025-02-04

111,414 downloads per month
Used in 78 crates (18 directly)

Apache-2.0

50KB
1K SLoC

sorted_vec

Create and maintain collections of sorted elements.

Documentation

let mut v = SortedVec::new();
assert_eq!(v.insert (5), 0);
assert_eq!(v.insert (3), 0);
assert_eq!(v.insert (4), 1);
assert_eq!(v.insert (4), 1);
assert_eq!(v.len(), 4);
v.dedup();
assert_eq!(v.len(), 3);
assert_eq!(v.binary_search (&3), Ok (0));
assert_eq!(*SortedVec::from_unsorted (
  vec![5, -10, 99, -11, 2, 17, 10]),
  vec![-11, -10, 2, 5, 10, 17, 99]);

Also provides sorted set containers only containing unique elements.

serde support

serde de/serialization is an optional feature.

By default, deserializing an unsorted container is an error.

To sort on deserialization, tag the field with #[serde(deserialize_with = "SortedVec::deserialize_unsorted")]:

#[derive(Debug, Eq, Ord, PartialEq, PartialOrd, Deserialize, Serialize)]
pub struct Foo {
  #[serde(deserialize_with = "SortedVec::deserialize_unsorted")]
  pub v : SortedVec <u64>
}

lib.rs:

Sorted vectors.

Repository

  • SortedVec -- sorted from least to greatest, may contain duplicates
  • SortedSet -- sorted from least to greatest, unique elements
  • ReverseSortedVec -- sorted from greatest to least, may contain duplicates
  • ReverseSortedSet -- sorted from greatest to least, unique elements

The partial module provides sorted vectors of types that only implement PartialOrd where comparison of incomparable elements results in runtime panic.

Dependencies

~155KB