Crate rangetools

Expand description

Extra methods for the standard library Range types:

To extend these types with the methods in this crate, import the Rangetools trait:

use rangetools::Rangetools;

This provides new methods on all of the above types, as well as any types introduced in this crate to manage the outputs of such methods.

use rangetools::Rangetools;

let i = (0..5).intersection(3..);
assert!(i.contains(4));

let i2 = (0..5).intersection(5..10);
assert!(i2.is_empty());

Wherever possible (when the result is lower-bounded), the resulting types of these operations implement IntoIterator so that more operations can be performed on them.

use rangetools::Rangetools;

let u1 = (1..3).union(5..7);
assert_eq!(u1.into_iter().collect::<Vec<_>>(), vec![1, 2, 5, 6]);

let u2 = (1..3).union(10..);
assert_eq!(u2.into_iter().take(5).collect::<Vec<_>>(), vec![1, 2, 10, 11, 12]);

let c = (1..3).complement();
let i = c.into_iter(); // Compiler error! The result has no lower bound
                       // and thus cannot be iterated over.

§Crate features

serde - When enabled, derives [serde]’s Serialize and Deserialize traits for all of the types introduced in this crate.

Structs§

BoundedRange: A range bounded both below and above (either inclusive or exclusive).
BoundedRangeIter: An iterator over the values contained by a BoundedRange.
BoundedSet: A set of ranges ultimately bounded both below and above.
BoundedSetIter: An iterator over the values contained by a BoundedSet.
EmptyRange: A range with no elements.
LowerBound: Lower bound of a range.
LowerBoundedRange: A range only bounded below (either inclusive or exclusive).
LowerBoundedRangeIter: An iterator over the values contained by a LowerBoundedRange.
LowerBoundedSet: A set of ranges with a finite lower bound but no upper bound.
LowerBoundedSetIter: An iterator over the values contained by a LowerBoundedSet.
PiecewiseUnboundedSet: A set of ranges with ultimately no upper or lower bound.
UnboundedRange: A range with no upper or lower bound.
UpperBound: Upper bound of a range.
UpperBoundedRange: A range only bounded above (either inclusive or exclusive).
UpperBoundedSet: A set of ranges with a finite upper bound but no lower bound.

Enums§

Bound: Endpoints of a closed range.
UnboundedSet: A set of ranges ultimately with no upper or lower bound.

Traits§

RangeComplement: Helper trait for performing range complement.
RangeIntersection: Helper trait for performing range intersection.
RangeUnion: Helper trait for performing range unions.
Rangetools: Extends the standard library Range types with extra functionality.
Step: Types are required to implement this trait for ranges of that type to be iterated through.