postgres_range/

lib.rs

//! Types dealing with ranges of values
#![doc(html_root_url = "https://sfackler.github.io/rust-postgres-range/doc/v0.11")]
#![warn(clippy::all, rust_2018_idioms, missing_docs)]

#[macro_use(to_sql_checked)]
extern crate postgres_types;

#[cfg(feature = "with-chrono-0_4")]
mod chrono_04;

use std::cmp::Ordering;
use std::fmt;
use std::i32;
use std::i64;
use std::marker::PhantomData;

use BoundSide::{Lower, Upper};
use BoundType::{Exclusive, Inclusive};
use InnerRange::{Empty, Normal};

/// The `range!` macro can make it easier to create ranges. It roughly mirrors
/// traditional mathematic range syntax.
///
/// ## Example
///
/// ```rust
///
/// #[macro_use]
/// extern crate postgres_range;
///
/// use postgres_range::Range;
///
/// fn main() {
///     let mut r: Range<i32>;
///     // a closed interval
///     r = range!('[' 5i32, 10i32; ']');
///     // an open interval
///     r = range!('(' 5i32, 10i32; ')');
///     // half-open intervals
///     r = range!('(' 5i32, 10i32; ']');
///     r = range!('[' 5i32, 10i32; ')');
///     // a closed lower-bounded interval
///     r = range!('[' 5i32,; ')');
///     // an open lower-bounded interval
///     r = range!('(' 5i32,; ')');
///     // a closed upper-bounded interval
///     r = range!('(', 10i32; ']');
///     // an open upper-bounded interval
///     r = range!('(', 10i32; ')');
///     // an unbounded interval
///     r = range!('(',; ')');
///     // an empty interval
///     r = range!(empty);
/// }
#[macro_export]
macro_rules! range {
    (empty) => ($crate::Range::empty());
    ('(',; ')') => ($crate::Range::new(None, None));
    ('(', $h:expr; ')') => (
        $crate::Range::new(None,
            Some($crate::RangeBound::new($h,
                $crate::BoundType::Exclusive)))
    );
    ('(', $h:expr; ']') => (
        $crate::Range::new(None,
            Some($crate::RangeBound::new($h,
                $crate::BoundType::Inclusive)))
    );
    ('(' $l:expr,; ')') => (
        $crate::Range::new(
            Some($crate::RangeBound::new($l,
                $crate::BoundType::Exclusive)), None)
    );
    ('[' $l:expr,; ')') => (
        $crate::Range::new(
            Some($crate::RangeBound::new($l,
                $crate::BoundType::Inclusive)), None)
    );
    ('(' $l:expr, $h:expr; ')') => (
        $crate::Range::new(
            Some($crate::RangeBound::new($l,
                $crate::BoundType::Exclusive)),
            Some($crate::RangeBound::new($h,
                $crate::BoundType::Exclusive)))
    );
    ('(' $l:expr, $h:expr; ']') => (
        $crate::Range::new(
            Some($crate::RangeBound::new($l,
                $crate::BoundType::Exclusive)),
            Some($crate::RangeBound::new($h,
                $crate::BoundType::Inclusive)))
    );
    ('[' $l:expr, $h:expr; ')') => (
        $crate::Range::new(
            Some($crate::RangeBound::new($l,
                $crate::BoundType::Inclusive)),
            Some($crate::RangeBound::new($h,
                $crate::BoundType::Exclusive)))
    );
    ('[' $l:expr, $h:expr; ']') => (
        $crate::Range::new(
            Some($crate::RangeBound::new($l,
                $crate::BoundType::Inclusive)),
            Some($crate::RangeBound::new($h,
                $crate::BoundType::Inclusive)))
    )
}

mod impls;

/// A trait that normalizes a range bound for a type
pub trait Normalizable: Sized {
    /// Given a range bound, returns the normalized version of that bound. For
    /// discrete types such as i32, the normalized lower bound is always
    /// inclusive and the normalized upper bound is always exclusive. Other
    /// types, such as Timespec, have no normalization process so their
    /// implementation is a no-op.
    ///
    /// The logic here should match the logic performed by the equivalent
    /// Postgres type.
    fn normalize<S>(bound: RangeBound<S, Self>) -> RangeBound<S, Self>
    where
        S: BoundSided;
}

macro_rules! bounded_normalizable {
    ($t:ident) => (
        impl Normalizable for $t {
            fn normalize<S>(bound: RangeBound<S, $t>) -> RangeBound<S, $t> where S: BoundSided {
                match (<S as BoundSided>::side(), bound.type_) {
                    (Upper, Inclusive) => {
                        assert!(bound.value != $t::MAX);
                        RangeBound::new(bound.value + 1, Exclusive)
                    }
                    (Lower, Exclusive) => {
                        assert!(bound.value != $t::MAX);
                        RangeBound::new(bound.value + 1, Inclusive)
                    }
                    _ => bound
                }
            }
        }
    )
}

bounded_normalizable!(i32);
bounded_normalizable!(i64);

/// The possible sides of a bound.
#[derive(Debug, PartialEq, Eq, Clone, Copy)]
pub enum BoundSide {
    /// An upper bound.
    Upper,
    /// A lower bound.
    Lower,
}

/// A trait implemented by phantom types indicating the type of the bound.
pub trait BoundSided {
    /// Returns the bound side this type corresponds to.
    fn side() -> BoundSide;
}

/// A tag type representing an upper bound
pub enum UpperBound {}

/// A tag type representing a lower bound
pub enum LowerBound {}

impl BoundSided for UpperBound {
    fn side() -> BoundSide {
        Upper
    }
}

impl BoundSided for LowerBound {
    fn side() -> BoundSide {
        Lower
    }
}

/// The type of a range bound.
#[derive(Debug, PartialEq, Eq, Clone, Copy)]
pub enum BoundType {
    /// The bound includes its value.
    Inclusive,
    /// The bound excludes its value.
    Exclusive,
}

/// Represents a one-sided bound.
///
/// The side is determined by the `S` phantom parameter.
pub struct RangeBound<S: BoundSided, T> {
    /// The value of the bound.
    pub value: T,
    /// The type of the bound.
    pub type_: BoundType,
    _m: PhantomData<S>,
}

fn _is_send_sync() {
    fn is_send_sync<T: Send + Sync>() {}
    is_send_sync::<RangeBound<LowerBound, i32>>();
}

impl<S, T> Copy for RangeBound<S, T>
where
    S: BoundSided,
    T: Copy,
{
}

impl<S, T> Clone for RangeBound<S, T>
where
    S: BoundSided,
    T: Clone,
{
    fn clone(&self) -> RangeBound<S, T> {
        RangeBound {
            value: self.value.clone(),
            type_: self.type_,
            _m: PhantomData,
        }
    }
}

impl<S, T> fmt::Debug for RangeBound<S, T>
where
    S: BoundSided,
    T: fmt::Debug,
{
    fn fmt(&self, fmt: &mut fmt::Formatter<'_>) -> fmt::Result {
        fmt.debug_struct("RangeBound")
            .field("value", &self.value)
            .field("type_", &self.type_)
            .finish()
    }
}

impl<S, T> fmt::Display for RangeBound<S, T>
where
    S: BoundSided,
    T: fmt::Display,
{
    fn fmt(&self, fmt: &mut fmt::Formatter<'_>) -> fmt::Result {
        let (lower, upper) = match self.type_ {
            Inclusive => ('[', ']'),
            Exclusive => ('(', ')'),
        };

        match <S as BoundSided>::side() {
            Lower => write!(fmt, "{}{}", lower, self.value),
            Upper => write!(fmt, "{}{}", self.value, upper),
        }
    }
}

impl<S, T> PartialEq for RangeBound<S, T>
where
    S: BoundSided,
    T: PartialEq,
{
    fn eq(&self, other: &RangeBound<S, T>) -> bool {
        self.value == other.value && self.type_ == other.type_
    }

    /*fn ne(&self, other: &RangeBound<S, T>) -> bool {
        self.value != other.value || self.type_ != other.type_
    }*/
}

impl<S, T> Eq for RangeBound<S, T>
where
    S: BoundSided,
    T: Eq,
{
}

impl<S, T> PartialOrd for RangeBound<S, T>
where
    S: BoundSided,
    T: PartialOrd,
{
    fn partial_cmp(&self, other: &RangeBound<S, T>) -> Option<Ordering> {
        match (
            <S as BoundSided>::side(),
            self.type_,
            other.type_,
            self.value.partial_cmp(&other.value),
        ) {
            (Upper, Exclusive, Inclusive, Some(Ordering::Equal)) | (Lower, Inclusive, Exclusive, Some(Ordering::Equal)) => Some(Ordering::Less),
            (Upper, Inclusive, Exclusive, Some(Ordering::Equal)) | (Lower, Exclusive, Inclusive, Some(Ordering::Equal)) => Some(Ordering::Greater),
            (_, _, _, cmp) => cmp,
        }
    }
}

impl<S, T> Ord for RangeBound<S, T>
where
    S: BoundSided,
    T: Ord,
{
    fn cmp(&self, other: &RangeBound<S, T>) -> Ordering {
        match (
            <S as BoundSided>::side(),
            self.type_,
            other.type_,
            self.value.cmp(&other.value),
        ) {
            (Upper, Exclusive, Inclusive, Ordering::Equal) | (Lower, Inclusive, Exclusive, Ordering::Equal) => Ordering::Less,
            (Upper, Inclusive, Exclusive, Ordering::Equal) | (Lower, Exclusive, Inclusive, Ordering::Equal) => Ordering::Greater,
            (_, _, _, ord) => ord,
        }
    }
}

impl<S, T> RangeBound<S, T>
where
    S: BoundSided,
    T: PartialOrd,
{
    /// Constructs a new range bound
    pub fn new(value: T, type_: BoundType) -> RangeBound<S, T> {
        RangeBound {
            value,
            type_,
            _m: PhantomData,
        }
    }

    /// Determines if a value lies within the range specified by this bound.
    pub fn in_bounds(&self, value: &T) -> bool {
        match (self.type_, <S as BoundSided>::side()) {
            (Inclusive, Upper) => value <= &self.value,
            (Exclusive, Upper) => value < &self.value,
            (Inclusive, Lower) => value >= &self.value,
            (Exclusive, Lower) => value > &self.value,
        }
    }
}

struct OptBound<'a, S: BoundSided, T>(Option<&'a RangeBound<S, T>>);

impl<'a, S, T> PartialEq for OptBound<'a, S, T>
where
    S: BoundSided,
    T: PartialEq,
{
    fn eq(&self, &OptBound(ref other): &OptBound<'a, S, T>) -> bool {
        let &OptBound(ref self_) = self;
        self_ == other
    }

    /*fn ne(&self, &OptBound(ref other): &OptBound<'a, S, T>) -> bool {
        let &OptBound(ref self_) = self;
        self_ != other
    }*/
}

impl<'a, S, T> PartialOrd for OptBound<'a, S, T>
where
    S: BoundSided,
    T: PartialOrd,
{
    fn partial_cmp(&self, other: &OptBound<'a, S, T>) -> Option<Ordering> {
        match (self, other, <S as BoundSided>::side()) {
            (&OptBound(None), &OptBound(None), _) => Some(Ordering::Equal),
            (&OptBound(None), _, Lower) | (_, &OptBound(None), Upper) => Some(Ordering::Less),
            (&OptBound(None), _, Upper) | (_, &OptBound(None), Lower) => Some(Ordering::Greater),
            (&OptBound(Some(a)), &OptBound(Some(b)), _) => a.partial_cmp(b),
        }
    }
}

/// Represents a range of values.
#[derive(Debug, PartialEq, Eq, Clone, Copy)]
pub struct Range<T> {
    inner: InnerRange<T>,
}

#[derive(Debug, PartialEq, Eq, Clone, Copy)]
enum InnerRange<T> {
    Empty,
    Normal(
        Option<RangeBound<LowerBound, T>>,
        Option<RangeBound<UpperBound, T>>,
    ),
}

impl<T> fmt::Display for Range<T>
where
    T: fmt::Display,
{
    fn fmt(&self, fmt: &mut fmt::Formatter<'_>) -> fmt::Result {
        match self.inner {
            Empty => write!(fmt, "empty"),
            Normal(ref lower, ref upper) => {
                match *lower {
                    Some(ref bound) => write!(fmt, "{}", bound)?,
                    None => write!(fmt, "(")?,
                }
                write!(fmt, ",")?;
                match *upper {
                    Some(ref bound) => write!(fmt, "{}", bound),
                    None => write!(fmt, ")"),
                }
            }
        }
    }
}

impl<T> Range<T>
where
    T: PartialOrd + Normalizable,
{
    /// Creates a new range.
    ///
    /// If a bound is `None`, the range is unbounded in that direction.
    pub fn new(lower: Option<RangeBound<LowerBound, T>>, upper: Option<RangeBound<UpperBound, T>>) -> Range<T> {
        let lower = lower.map(Normalizable::normalize);
        let upper = upper.map(Normalizable::normalize);

        if let (&Some(ref lower), &Some(ref upper)) = (&lower, &upper) {
            let empty = match (lower.type_, upper.type_) {
                (Inclusive, Inclusive) => lower.value > upper.value,
                _ => lower.value >= upper.value,
            };
            if empty {
                return Range { inner: Empty };
            }
        }

        Range {
            inner: Normal(lower, upper),
        }
    }

    /// Creates a new empty range.
    pub fn empty() -> Range<T> {
        Range { inner: Empty }
    }

    /// Determines if this range is the empty range.
    pub fn is_empty(&self) -> bool {
        match self.inner {
            Empty => true,
            Normal(..) => false,
        }
    }

    /// Returns the lower bound if it exists.
    pub fn lower(&self) -> Option<&RangeBound<LowerBound, T>> {
        match self.inner {
            Normal(Some(ref lower), _) => Some(lower),
            _ => None,
        }
    }

    /// Returns the upper bound if it exists.
    pub fn upper(&self) -> Option<&RangeBound<UpperBound, T>> {
        match self.inner {
            Normal(_, Some(ref upper)) => Some(upper),
            _ => None,
        }
    }

    /// Determines if a value lies within this range.
    pub fn contains(&self, value: &T) -> bool {
        match self.inner {
            Empty => false,
            Normal(ref lower, ref upper) => {
                lower.as_ref().map_or(true, |b| {
                    b.in_bounds(value)
                }) && upper.as_ref().map_or(true, |b| {
                    b.in_bounds(value)
                })
            }
        }
    }

    /// Determines if a range lies completely within this range.
    pub fn contains_range(&self, other: &Range<T>) -> bool {
        if other.is_empty() {
            return true;
        }

        if self.is_empty() {
            return false;
        }

        OptBound(self.lower()) <= OptBound(other.lower()) && OptBound(self.upper()) >= OptBound(other.upper())
    }
}

fn order<T>(a: T, b: T) -> (T, T)
where
    T: PartialOrd,
{
    if a < b {
        (a, b)
    } else {
        (b, a)
    }
}

impl<T> Range<T>
where
    T: PartialOrd + Normalizable + Clone,
{
    /// Returns the intersection of this range with another.
    pub fn intersect(&self, other: &Range<T>) -> Range<T> {
        if self.is_empty() || other.is_empty() {
            return Range::empty();
        }

        let (_, OptBound(lower)) = order(OptBound(self.lower()), OptBound(other.lower()));
        let (OptBound(upper), _) = order(OptBound(self.upper()), OptBound(other.upper()));

        Range::new(lower.cloned(), upper.cloned())
    }

    /// Returns the union of this range with another if it is contiguous.
    pub fn union(&self, other: &Range<T>) -> Option<Range<T>> {
        if self.is_empty() {
            return Some(other.clone());
        }

        if other.is_empty() {
            return Some(self.clone());
        }

        let (OptBound(l_lower), OptBound(u_lower)) = order(OptBound(self.lower()), OptBound(other.lower()));
        let (OptBound(l_upper), OptBound(u_upper)) = order(OptBound(self.upper()), OptBound(other.upper()));

        let discontiguous = match (u_lower, l_upper) {
            (
                Some(&RangeBound {
                    value: ref l,
                    type_: Exclusive,
                    ..
                }),
                Some(&RangeBound {
                    value: ref u,
                    type_: Exclusive,
                    ..
                }),
            ) => l >= u,
            (Some(&RangeBound { value: ref l, .. }), Some(&RangeBound { value: ref u, .. })) => l > u,
            _ => false,
        };

        if discontiguous {
            None
        } else {
            Some(Range::new(
                l_lower.cloned(),
                u_upper.cloned(),
            ))
        }
    }
}

#[cfg(test)]
mod test {
    use std::i32;

    use super::{BoundType, LowerBound, Normalizable, Range, RangeBound, UpperBound};
    use super::BoundType::{Exclusive, Inclusive};

    #[test]
    fn test_range_bound_lower_lt() {
        fn check(val1: isize, inc1: BoundType, val2: isize, inc2: BoundType, expected: bool) {
            let a: RangeBound<LowerBound, isize> = RangeBound::new(val1, inc1);
            let b: RangeBound<LowerBound, isize> = RangeBound::new(val2, inc2);
            assert_eq!(expected, a < b);
        }

        check(1, Inclusive, 2, Exclusive, true);
        check(1, Exclusive, 2, Inclusive, true);
        check(1, Inclusive, 1, Exclusive, true);
        check(2, Inclusive, 1, Inclusive, false);
        check(2, Exclusive, 1, Exclusive, false);
        check(1, Exclusive, 1, Inclusive, false);
        check(1, Exclusive, 1, Exclusive, false);
        check(1, Inclusive, 1, Inclusive, false);
    }

    #[test]
    fn test_range_bound_upper_lt() {
        fn check(val1: isize, inc1: BoundType, val2: isize, inc2: BoundType, expected: bool) {
            let a: RangeBound<UpperBound, isize> = RangeBound::new(val1, inc1);
            let b: RangeBound<UpperBound, isize> = RangeBound::new(val2, inc2);
            assert_eq!(expected, a < b);
        }

        check(1, Inclusive, 2, Exclusive, true);
        check(1, Exclusive, 2, Exclusive, true);
        check(1, Exclusive, 1, Inclusive, true);
        check(2, Inclusive, 1, Inclusive, false);
        check(2, Exclusive, 1, Exclusive, false);
        check(1, Inclusive, 1, Exclusive, false);
        check(1, Inclusive, 1, Inclusive, false);
        check(1, Exclusive, 1, Exclusive, false);
    }

    #[test]
    fn test_range_bound_lower_in_bounds() {
        fn check(bound: isize, inc: BoundType, val: isize, expected: bool) {
            let b: RangeBound<LowerBound, isize> = RangeBound::new(bound, inc);
            assert_eq!(expected, b.in_bounds(&val));
        }

        check(1, Inclusive, 1, true);
        check(1, Exclusive, 1, false);
        check(1, Inclusive, 2, true);
        check(1, Inclusive, 0, false);
    }

    #[test]
    fn test_range_bound_upper_in_bounds() {
        fn check(bound: isize, inc: BoundType, val: isize, expected: bool) {
            let b: RangeBound<UpperBound, isize> = RangeBound::new(bound, inc);
            assert_eq!(expected, b.in_bounds(&val));
        }

        check(1, Inclusive, 1, true);
        check(1, Exclusive, 1, false);
        check(1, Inclusive, 2, false);
        check(1, Inclusive, 0, true);
    }

    #[test]
    fn test_range_contains() {
        let r = range!('[' 1i32, 3i32; ']');
        assert!(!r.contains(&4));
        assert!(r.contains(&3));
        assert!(r.contains(&2));
        assert!(r.contains(&1));
        assert!(!r.contains(&0));

        let r = range!('(' 1i32, 3i32; ')');
        assert!(!r.contains(&4));
        assert!(!r.contains(&3));
        assert!(r.contains(&2));
        assert!(!r.contains(&1));
        assert!(!r.contains(&0));

        let r = range!('(', 3i32; ']');
        assert!(!r.contains(&4));
        assert!(r.contains(&2));
        assert!(r.contains(&i32::MIN));

        let r = range!('[' 1i32,; ')');
        assert!(r.contains(&i32::MAX));
        assert!(r.contains(&4));
        assert!(!r.contains(&0));

        let r = range!('(',; ')');
        assert!(r.contains(&i32::MAX));
        assert!(r.contains(&0i32));
        assert!(r.contains(&i32::MIN));
    }

    #[test]
    fn test_normalize_lower() {
        let r: RangeBound<LowerBound, i32> = RangeBound::new(10i32, Inclusive);
        assert_eq!(
            RangeBound::new(10i32, Inclusive),
            Normalizable::normalize(r)
        );

        let r: RangeBound<LowerBound, i32> = RangeBound::new(10i32, Exclusive);
        assert_eq!(
            RangeBound::new(11i32, Inclusive),
            Normalizable::normalize(r)
        );
    }

    #[test]
    fn test_normalize_upper() {
        let r: RangeBound<UpperBound, i32> = RangeBound::new(10i32, Inclusive);
        assert_eq!(
            RangeBound::new(11i32, Exclusive),
            Normalizable::normalize(r)
        );

        let r: RangeBound<UpperBound, i32> = RangeBound::new(10i32, Exclusive);
        assert_eq!(
            RangeBound::new(10i32, Exclusive),
            Normalizable::normalize(r)
        );
    }

    #[test]
    fn test_range_normalizes() {
        let r1 = range!('(' 10i32, 15i32; ']');
        let r2 = range!('[' 11i32, 16i32; ')');
        assert_eq!(r1, r2);
    }

    #[test]
    fn test_range_empty() {
        assert!((range!('(' 9i32, 10i32; ')')).is_empty());
        assert!((range!('[' 10i32, 10i32; ')')).is_empty());
        assert!((range!('(' 10i32, 10i32; ']')).is_empty());
        assert!((range!('[' 10i32, 9i32; ']')).is_empty());
    }

    #[test]
    fn test_intersection() {
        let r1 = range!('[' 10i32, 15i32; ')');
        let r2 = range!('(' 20i32, 25i32; ']');
        assert!(r1.intersect(&r2).is_empty());
        assert!(r2.intersect(&r1).is_empty());
        assert_eq!(r1, r1.intersect(&range!('(',; ')')));
        assert_eq!(r1, (range!('(',; ')')).intersect(&r1));

        let r2 = range!('(' 10i32,; ')');
        let exp = Range::new(r2.lower().copied(), r1.upper().copied());
        assert_eq!(exp, r1.intersect(&r2));
        assert_eq!(exp, r2.intersect(&r1));

        let r2 = range!('(', 15i32; ']');
        assert_eq!(r1, r1.intersect(&r2));
        assert_eq!(r1, r2.intersect(&r1));

        let r2 = range!('[' 11i32, 14i32; ')');
        assert_eq!(r2, r1.intersect(&r2));
        assert_eq!(r2, r2.intersect(&r1));
    }

    #[test]
    fn test_union() {
        let r1 = range!('[' 10i32, 15i32; ')');
        let r2 = range!('(' 20i32, 25i32; ']');
        assert_eq!(None, r1.union(&r2));
        assert_eq!(None, r2.union(&r1));

        let r2 = range!('(',; ')');
        assert_eq!(Some(r2), r1.union(&r2));
        assert_eq!(Some(r2), r2.union(&r1));

        let r2 = range!('[' 13i32, 50i32; ')');
        assert_eq!(Some(range!('[' 10i32, 50i32; ')')), r1.union(&r2));
        assert_eq!(Some(range!('[' 10i32, 50i32; ')')), r2.union(&r1));

        let r2 = range!('[' 3i32, 50i32; ')');
        assert_eq!(Some(range!('[' 3i32, 50i32; ')')), r1.union(&r2));
        assert_eq!(Some(range!('[' 3i32, 50i32; ')')), r2.union(&r1));

        let r2 = range!('(', 11i32; ')');
        assert_eq!(Some(range!('(', 15i32; ')')), r1.union(&r2));
        assert_eq!(Some(range!('(', 15i32; ')')), r2.union(&r1));

        let r2 = range!('(' 11i32,; ')');
        assert_eq!(Some(range!('[' 10i32,; ')')), r1.union(&r2));
        assert_eq!(Some(range!('[' 10i32,; ')')), r2.union(&r1));

        let r2 = range!('(' 15i32, 20i32; ')');
        assert_eq!(None, r1.union(&r2));
        assert_eq!(None, r2.union(&r1));

        let r2 = range!('[' 15i32, 20i32; ']');
        assert_eq!(Some(range!('[' 10i32, 20i32; ']')), r1.union(&r2));
        assert_eq!(Some(range!('[' 10i32, 20i32; ']')), r2.union(&r1));
    }

    #[test]
    fn test_contains_range() {
        assert!(Range::<i32>::empty().contains_range(&Range::empty()));

        let r1 = range!('[' 10i32, 15i32; ')');
        assert!(r1.contains_range(&r1));

        let r2 = range!('(' 10i32,; ')');
        assert!(!r1.contains_range(&r2));
        assert!(!r2.contains_range(&r1));

        let r2 = range!('(', 15i32; ']');
        assert!(!r1.contains_range(&r2));
        assert!(r2.contains_range(&r1));
    }
}