Trait wyz::range::RangeExt

pub trait RangeExt<T>: RangeBounds<T>
where
    T: Ord,
{
    // Required methods
    fn normalize(
        self,
        start: impl Into<Option<T>>,
        end: impl Into<Option<T>>,
    ) -> Range<T>;
    fn intersection<R>(self, other: R) -> Option<Range<T>>
       where R: RangeExt<T>;
    fn union<R>(self, other: R) -> Option<Range<T>>
       where R: RangeExt<T>;
}

Extension methods for working with various range types.

Required Methods

fn normalize( self, start: impl Into<Option<T>>, end: impl Into<Option<T>>, ) -> Range<T>

Normalizes a range-like type to a canonical half-open Range.

Parameters

• self: The range to normalize.
• start: An optional fallback inclusive lower bound.
• end: An optional fallback exclusive upper bound.

Returns

A Range whose start and end values are the following, in order of decreasing priority:

• self.start(), or if absent, the start parameter, or if it is None, 0.
• self.end(), or if absent, the end parameter, or if it is None, !0`.

fn intersection<R>(self, other: R) -> Option<Range<T>>

where R: RangeExt<T>,

Finds the intersection between two range-likes. The produced Range spans only the elements common to both.

This returns None if the ranges do not have an intersection (at least one element present in both ranges).

fn union<R>(self, other: R) -> Option<Range<T>>

where R: RangeExt<T>,

Finds the union between two range-likes. The produced Range spans all elements present in at least one of them.

This returns None if the ranges do not have an intersection (at least one element present in both ranges).

Object Safety

This trait is not object safe.

Implementors

impl<R> RangeExt<usize> for R

where R: RangeBounds<usize>,