ordmask 2.1.0

A library for efficient range-based set operations and membership checking
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68

/// Create an [`OrdMask`](crate::OrdMask) from key points.
///
/// # Panics
///
/// Panics if key points are not in non-decreasing order.
///
/// # Examples
///
/// ```
/// use ordmask::{OrdMask, ordmask};
///
/// let mask = ordmask![<i32>]; // or: let mask: OrdMask<i32> = ordmask![];
/// assert_eq!(mask, OrdMask::<i32>::empty());
///
/// let mask = ordmask![<u64>..]; // or: let mask: OrdMask<u64> = ordmask![..];
/// assert_eq!(mask, OrdMask::<u64>::universal());
///
/// let mask = ordmask![0, 10, 20]; // can also use ordmask![<i32> 0, 10, 20]
/// assert_eq!(mask, OrdMask::from(vec![0, 10, 20]));
///
/// let mask = ordmask![.., 0, 10, 20]; // can also use ordmask![<i32> .., 0, 10, 20]
/// assert_eq!(mask, OrdMask::from_complement(vec![0, 10, 20]));
/// ```
#[macro_export]
macro_rules! ordmask {
    ($(<$T: ty>)?) => {
        ordmask::OrdMask$(::<$T>)?::empty()
    };
    ($(<$T: ty>)? ..) => {
        ordmask::OrdMask$(::<$T>)?::universal()
    };
    ($(<$T: ty>)? .., $($key_points:expr),+ $(,)?) => {
        ordmask::OrdMask$(::<$T>)?::from_complement(vec![$($key_points),+])
    };
    (<$T: ty> $($key_points:expr),+ $(,)?) => {
        ordmask::OrdMask::<$T>::from(vec![$($key_points),+])
    };
    ($($key_points:expr),+ $(,)?) => {
        ordmask::OrdMask::from(vec![$($key_points),+])
    };
}

/// Create an [`OrdMask`](crate::OrdMask) from key points without validation.
///
/// Usage is similar to [`ordmask!`], but
/// without the non-decreasing check and [`OrdMask::simplify`](crate::OrdMask::simplify).
///
/// # Safety
///
/// Key points must be non-decreasing.
#[macro_export]
macro_rules! ordmask_uncheck {
    ($($T: ty)?) => {
        ordmask::OrdMask$(::<$T>)?::empty()
    };
    ($($T: ty;)? ..) => {
        ordmask::OrdMask$(::<$T>)?::universal()
    };
    ($($T: ty;)? .., $($key_points:expr),+ $(,)?) => {
        ordmask::OrdMask$(::<$T>)?::with_checked(vec![$($key_points),+], true)
    };
    ($T: ty; $($key_points:expr),+ $(,)?) => {
        ordmask::OrdMask::<$T>::with_checked(vec![$($key_points),+], false)
    };
    ($($key_points:expr),+ $(,)?) => {
        ordmask::OrdMask::with_checked(vec![$($key_points),+], false)
    };
}