#collation #bisect #stream #bisection #order #utilities #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

#340 in Rust patterns

Download history 378/week @ 2024-10-16 542/week @ 2024-10-23 560/week @ 2024-10-30 360/week @ 2024-11-06 222/week @ 2024-11-13 171/week @ 2024-11-20 187/week @ 2024-11-27 154/week @ 2024-12-04 194/week @ 2024-12-11 158/week @ 2024-12-18 5/week @ 2024-12-25 33/week @ 2025-01-01 171/week @ 2025-01-08 127/week @ 2025-01-15 219/week @ 2025-01-22 194/week @ 2025-01-29

719 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