#range #set-operations #difference #union #intersection #complement #integer

irange

A data structure to store and manipulate ranges of integers with set operations

4 stable releases

1.1.2 Sep 5, 2024
1.1.1 Sep 2, 2024
1.1.0 Aug 30, 2024
1.0.0 Aug 25, 2024

#576 in Data structures

Download history 91/week @ 2024-08-19 182/week @ 2024-08-26 308/week @ 2024-09-02 14/week @ 2024-09-09 25/week @ 2024-09-16 9/week @ 2024-09-23 24/week @ 2024-09-30 9/week @ 2024-10-07

69 downloads per month
Used in 2 crates (via regex-charclass)

MIT license

35KB
767 lines

irange

Crates.io Version

A data structure to store and manipulate ranges of integers with set operations.

Supported types: u8, u16, u32, u64, u128, usize, i8, i16, i32, i64, i128 and isize.

Installation

Add the following line in your Cargo.toml:

[dependencies]
irange = "1.1"

If you need serde support you can include the following feature flag:

[dependencies]
irange = { version = "1.1", features = ["serde"] }

Examples

use irange::RangeSet;

let range1 = RangeSet::<i64>::new_from_ranges(&[AnyRange::from(3..=4), AnyRange::from(7..9)]);
let range2 = RangeSet::<i64>::new_from_range(-2..=4);

let union = range1.union(&range2);
println!("{union}"); // [ -2..=4 7..=8 ]
for value in union.iter() {
    print!("{value} "); // -2 -1 0 1 2 3 4 7 8
}
println!();

let intersection = range1.intersection(&range2);
println!("{intersection}"); // [ 3..=4 ]
for value in intersection.iter() {
    print!("{value} "); // 3 4
}
println!();

let difference = range1.difference(&range2);
println!("{difference}"); // [ 7..=8 ]
for value in difference.iter() {
    print!("{value} "); // 7 8
}
println!();

Supported Operations

Operation Description Time complexity Space complexity
union Compute the union with the given RangeSet. O(n) O(n)
intersection Compute the intersection with the given RangeSet. O(n) O(n)
difference Compute the difference with the given RangeSet. O(n) O(n)
complement Compute the complement. O(n) O(n)
has_intersection Return true if there is a common value with the given RangeSet. O(n) O(1)
contains Return true if it contains the given value. O(n) O(1)
contains_all Return true if it contains the given RangeSet. O(n) O(1)
is_total Return true if it contains all the possible values. O(1) O(1)
is_empty Return true if it does not contain any value. O(1) O(1)

Dependencies

~170KB