#collation #bisect #bisection #stream #data-structures #traits #structure

collate

Traits and a data structure to support collation and bisection

19 releases

0.4.2 Aug 13, 2024
0.4.1 Dec 20, 2023
0.4.0 Nov 6, 2023
0.3.0 Jul 3, 2023
0.1.1 Jan 18, 2021

#350 in Rust patterns

Download history 174/week @ 2024-11-22 149/week @ 2024-11-29 209/week @ 2024-12-06 215/week @ 2024-12-13 59/week @ 2024-12-20 18/week @ 2024-12-27 82/week @ 2025-01-03 165/week @ 2025-01-10 179/week @ 2025-01-17 188/week @ 2025-01-24 222/week @ 2025-01-31 334/week @ 2025-02-07 203/week @ 2025-02-14 192/week @ 2025-02-21 183/week @ 2025-02-28 104/week @ 2025-03-07

724 downloads per month
Used in 21 crates (9 directly)

Apache-2.0

36KB
807 lines

collate

Rust collation utilities

Example usage:

use collate::*;

let collator = Collator::default();
let collection = [
    [1, 2, 3],
    [2, 3, 4],
    [3, 4, 5],
];

assert_eq!(collator.bisect_left(&collection, &[1]), 0);
assert_eq!(collator.bisect_right(&collection, &[1]), 1);

lib.rs:

Defines a Collate trait to standardize collation methods across data types. The provided Collator struct can be used to collate a collection of items of type T where T: Ord.

Collate is useful for implementing a B-Tree, or to handle cases where a collator type is more efficient than calling Ord::cmp repeatedly, for example when collating localized strings using rust_icu_ucol. It's also useful to handle types like complex numbers which do not necessarily have a natural ordering.

Use the "stream" feature flag to enable diff and try_diff functions to compute the difference between two collated Streams, and the merge and try_merge functions to merge two collated Streams.

Dependencies

~245KB