pub struct I32CO { /* private fields */ }Implementations§
Source§impl I32CO
impl I32CO
pub const fn try_new(start: i32, end_excl: i32) -> Option<Self>
pub const unsafe fn new_unchecked(start: i32, end_excl: i32) -> Self
Sourcepub const fn checked_from_midpoint_len(mid: i32, len: u32) -> Option<Self>
pub const fn checked_from_midpoint_len(mid: i32, len: u32) -> Option<Self>
Constructs an I32CO interval from a midpoint and length (u32).
§Parameters
mid: the desired midpoint of the intervallen: the desired length of the interval in units, must be1..=u32::MAX
§Returns
Some(I32CO)if the interval[start, end_excl)can be represented ini32Noneiflen = 0or the computedstart/end_exclwould overflowi32
§Guarantees
- Returned interval satisfies
start < end_excl - Maximum accepted input length is
u32::MAX
Sourcepub const fn saturating_from_midpoint_len(mid: i32, len: u32) -> Option<Self>
pub const fn saturating_from_midpoint_len(mid: i32, len: u32) -> Option<Self>
Constructs an I32CO interval from a midpoint and length (u32) with saturating semantics.
§Parameters
mid: the desired midpoint of the intervallen: the desired length of the interval in units, must be1..=u32::MAX
§Behavior
- Values are saturated at
i32::MIN/i32::MAXto prevent overflow. - If
len = 0, returnsNone.
§Guarantees
- Returned interval satisfies
start < end_excl - Maximum accepted input length is
u32::MAX - Fully compatible with codegen for other signed integer interval types
Source§impl I32CO
impl I32CO
pub const fn start(self) -> i32
pub const fn end_excl(self) -> i32
pub const fn end_incl(self) -> i32
pub const fn len(self) -> u32
Sourcepub const fn midpoint(self) -> i32
pub const fn midpoint(self) -> i32
Returns the midpoint of the interval [start, end_excl),
using floor division if the length is even.
§Guarantees
midpoint()∈[self.start, self.end_excl - 1]- Works for intervals with maximum length (entire
i32range)
pub const fn contains(self, x: i32) -> bool
pub const fn contains_interval(self, other: Self) -> bool
pub const fn iter(self) -> Range<i32>
pub const fn to_range(self) -> Range<i32>
pub const fn intersects(self, other: Self) -> bool
pub const fn is_adjacent(self, other: Self) -> bool
pub const fn is_contiguous_with(self, other: Self) -> bool
Source§impl I32CO
impl I32CO
Sourcepub const fn intersection(self, other: Self) -> Option<Self>
pub const fn intersection(self, other: Self) -> Option<Self>
Returns the intersection of two intervals.
If the intervals do not overlap, returns None.
Sourcepub const fn convex_hull(self, other: Self) -> Self
pub const fn convex_hull(self, other: Self) -> Self
Returns the convex hull (smallest interval containing both) of two intervals.
Always returns a valid I32CO.
Sourcepub const fn between(self, other: Self) -> Option<Self>
pub const fn between(self, other: Self) -> Option<Self>
Returns the interval strictly between two intervals.
If the intervals are contiguous or overlap, returns None.
Sourcepub const fn union(self, other: Self) -> OneTwo<Self>
pub const fn union(self, other: Self) -> OneTwo<Self>
Returns the union of two intervals.
- If intervals are contiguous or overlapping, returns
Onecontaining the merged interval. - Otherwise, returns
Twocontaining both intervals in ascending order.
Sourcepub const fn difference(self, other: Self) -> ZeroOneTwo<Self>
pub const fn difference(self, other: Self) -> ZeroOneTwo<Self>
Returns the difference of two intervals (self - other).
- If no overlap, returns
One(self). - If partial overlap, returns
OneorTwodepending on remaining segments. - If fully contained, returns
Zero.
Sourcepub const fn symmetric_difference(self, other: Self) -> ZeroOneTwo<Self>
pub const fn symmetric_difference(self, other: Self) -> ZeroOneTwo<Self>
Returns the symmetric difference of two intervals.
Equivalent to (self - other) ∪ (other - self).
- If intervals do not overlap, returns
Two(self, other)in order. - If intervals partially overlap, returns remaining non-overlapping segments as
OneorTwo.
Source§impl I32CO
impl I32CO
pub const fn checked_minkowski_add(self, other: Self) -> Option<Self>
pub const fn checked_minkowski_sub(self, other: Self) -> Option<Self>
pub const fn checked_minkowski_mul(self, other: Self) -> Option<Self>
pub const fn checked_minkowski_div(self, other: Self) -> Option<Self>
Source§impl I32CO
impl I32CO
pub const fn checked_minkowski_add_n(self, n: i32) -> Option<Self>
pub const fn checked_minkowski_sub_n(self, n: i32) -> Option<Self>
pub const fn checked_minkowski_mul_n(self, n: i32) -> Option<Self>
pub const fn checked_minkowski_div_n(self, n: i32) -> Option<Self>
Source§impl I32CO
impl I32CO
pub const fn saturating_minkowski_add(self, other: Self) -> Option<Self>
pub const fn saturating_minkowski_sub(self, other: Self) -> Option<Self>
pub const fn saturating_minkowski_mul(self, other: Self) -> Option<Self>
pub const fn saturating_minkowski_div(self, other: Self) -> Option<Self>
Source§impl I32CO
impl I32CO
pub const fn saturating_minkowski_add_n(self, n: i32) -> Option<Self>
pub const fn saturating_minkowski_sub_n(self, n: i32) -> Option<Self>
pub const fn saturating_minkowski_mul_n(self, n: i32) -> Option<Self>
pub const fn saturating_minkowski_div_n(self, n: i32) -> Option<Self>
Trait Implementations§
Source§impl Ord for I32CO
impl Ord for I32CO
1.21.0 (const: unstable) · Source§fn max(self, other: Self) -> Selfwhere
Self: Sized,
fn max(self, other: Self) -> Selfwhere
Self: Sized,
Compares and returns the maximum of two values. Read more
Source§impl PartialOrd for I32CO
impl PartialOrd for I32CO
impl Copy for I32CO
impl Eq for I32CO
impl StructuralPartialEq for I32CO
Auto Trait Implementations§
impl Freeze for I32CO
impl RefUnwindSafe for I32CO
impl Send for I32CO
impl Sync for I32CO
impl Unpin for I32CO
impl UnsafeUnpin for I32CO
impl UnwindSafe for I32CO
Blanket Implementations§
Source§impl<T> BorrowMut<T> for Twhere
T: ?Sized,
impl<T> BorrowMut<T> for Twhere
T: ?Sized,
Source§fn borrow_mut(&mut self) -> &mut T
fn borrow_mut(&mut self) -> &mut T
Mutably borrows from an owned value. Read more