Struct devela::num::RangeI32

#[repr(C)]
pub struct RangeI32<const RMIN: i32, const RMAX: i32>(/* private fields */);

Available on crate feature num only.

A signed integer that is known to be included in some inclusive range.

It has an optimized memory layout, so that Option<RangeI32> is the same size as RangeI32.

Examples

use devela::num::RangeI32;

assert![RangeI32::<5, 25>::new(4).is_none()];
assert![RangeI32::<5, 25>::new(26).is_none()];
assert![RangeI32::<5, 25>::new(5).unwrap().get() == 5];
assert![RangeI32::<5, 25>::new(25).unwrap().get() == 25];

assert![RangeI32::<5, 25>::VALID_VALUES == 21];
// Self::INVALID_VALUES + Self::VALID_VALUES == u32::MAX + 1.
assert![RangeI32::<5, 25>::INVALID_VALUES == u32::MAX - 21 + 1];

Implementations

impl<const RMIN: i32, const RMAX: i32> RangeI32<RMIN, RMAX>

pub const fn new(value: i32) -> Option<Self>

Returns a RangeI32 with the given value, only if it’s between RMIN and RMAX.

Returns None if value is not between RMIN and RMAX, inclusive, or if RMIN > RMAX.

pub const unsafe fn new_unchecked(value: i32) -> Self

Available on crate feature unsafe_num only.

Returns a RangeI32 if the given value is between RMIN and RMAX.

Panics

Panics in debug if the given value is not between RMIN and RMAX, inclusive, or if RMIN > RMAX.

Safety

The given value must be between RMIN and RMAX, inclusive.

pub const fn get(&self) -> i32

Returns the value as a primitive type.

pub const VALID_VALUES: u32 = _

Returns the number of valid values within the range from RMIN to RMAX, inclusive, as an unsigned integer with equal bit size.

Notice

A range where RMAX == RMIN will result in VALID_VALUES == 1, as expected.

But a range from i32::MIN to i32::MAX will result in VALID_VALUES == 0, instead of u32::MAX + 1, This is because the maximum number of representable values for a given bit-size can’t be represented using the same number of bits. In this case INVALID_VALUES will also be == 0.

This doesn’t matter as much because a RangeI32 with the largest range of values is really just a i32.

Remember that INVALID_VALUES + VALID_VALUES == u32::MAX + 1, which would wrap to 0.

pub const INVALID_VALUES: u32 = _

Returns the number of invalid values outside the range from RMIN to RMAX, inclusive, as an unsigned integer with equal bit size.

Notice

A range where RMAX == RMIN will result in INVALID_VALUES == u32::MAX, as expected.

A range from i32::MIN to i32::MAX will result in INVALID_VALUES == 0, also as expected. Just be aware that in this case VALID_VALUES will also be == 0 instead of u32::MAX + 1.

Trait Implementations

impl<const RMIN: i32, const RMAX: i32> Binary for RangeI32<RMIN, RMAX>

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl<const RMIN: i32, const RMAX: i32> BitSize<32> for RangeI32<RMIN, RMAX>

Available on crate feature mem only.

const BIT_SIZE: usize = _

The bit size of this type (only the relevant data part, without padding).

const MIN_BYTE_SIZE: usize = _

The rounded up byte size for this type.

fn bit_size(&self) -> usize

Returns the bit size of this type (only the relevant data part, without padding).

fn min_byte_size(&self) -> usize

Returns the rounded up byte size for this type.

impl<const RMIN: i32, const RMAX: i32> Clone for RangeI32<RMIN, RMAX>

fn clone(&self) -> RangeI32<RMIN, RMAX>

Returns a copy of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl<const RMIN: i32, const RMAX: i32> Debug for RangeI32<RMIN, RMAX>

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl<const RMIN: i32, const RMAX: i32> Display for RangeI32<RMIN, RMAX>

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl<const RMIN: i32, const RMAX: i32> From<RangeI32<RMIN, RMAX>> for i32

fn from(value: RangeI32<RMIN, RMAX>) -> i32

Converts to this type from the input type.

impl<const RMIN: i32, const RMAX: i32> FromStr for RangeI32<RMIN, RMAX>

type Err = ParseIntError

The associated error which can be returned from parsing.

fn from_str(s: &str) -> Result<Self, Self::Err>

Parses a string s to return a value of this type.

impl<const RMIN: i32, const RMAX: i32> Hash for RangeI32<RMIN, RMAX>

fn hash<__H: Hasher>(&self, state: &mut __H)

Feeds this value into the given Hasher.

fn hash_slice<H>(data: &[Self], state: &mut H)where H: Hasher, Self: Sized,

Feeds a slice of this type into the given Hasher.

impl<const RMIN: i32, const RMAX: i32> LowerHex for RangeI32<RMIN, RMAX>

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl<const RMIN: i32, const RMAX: i32> Num for RangeI32<RMIN, RMAX>

type Inner = i32

The internal representation of this numeric type.

type OpOut = RangeI32<RMIN, RMAX>

The output type for operations.

type OpRhs = RangeI32<RMIN, RMAX>

The right hand side type for operations.

fn num_into(self) -> Self::Inner

Returns the inner self representation.

fn num_from(from: Self::Inner) -> Result<Self>

Returns Self if given a valid value.

fn num_from_ref(from: &Self::Inner) -> Result<Self>

Returns Self if given a valid &value.

fn num_set(&mut self, value: Self::Inner) -> Result<()>

Sets self to the given valid value.

fn num_set_ref(&mut self, value: &Self::Inner) -> Result<()>

Sets self to the given valid &value.

fn num_is_zero(&self) -> Result<bool>

Returns true if self is zero.

fn num_is_one(&self) -> Result<bool>

Returns true if self is one.

fn num_get_zero() -> Result<Self>

Returns the number zero.

fn num_get_one() -> Result<Self>

Returns the number one.

fn num_set_zero(&mut self) -> Result<()>

Sets self to 0.

fn num_set_one(&mut self) -> Result<()>

Sets the number to one.

fn num_add(self, other: Self) -> Result<Self::OpOut>

Computes self + other.

fn num_add_ref(self, other: &Self) -> Result<Self::OpOut>

Computes self + &other.

fn num_ref_add(&self, other: Self) -> Result<Self::OpOut>

Computes &self + other.

fn num_ref_add_ref(&self, other: &Self) -> Result<Self::OpOut>

Computes &self + &other.

fn num_mul(self, other: Self) -> Result<Self::OpOut>

Computes self * other.

fn num_mul_ref(self, other: &Self) -> Result<Self::OpOut>

Computes self * &other.

fn num_ref_mul(&self, other: Self) -> Result<Self::OpOut>

Computes &self * other.

fn num_ref_mul_ref(&self, other: &Self) -> Result<Self::OpOut>

Computes &self * &other.

fn num_sub(self, other: Self) -> Result<Self::OpOut>

Computes self - other.

fn num_sub_ref(self, other: &Self) -> Result<Self::OpOut>

Computes self - &other.

fn num_ref_sub(&self, other: Self) -> Result<Self::OpOut>

Computes &self - other.

fn num_ref_sub_ref(&self, other: &Self) -> Result<Self::OpOut>

Computes &self - &other.

fn num_div(self, other: Self) -> Result<Self::OpOut>

Computes self / other.

fn num_div_ref(self, other: &Self) -> Result<Self::OpOut>

Computes self / &other.

fn num_ref_div(&self, other: Self) -> Result<Self::OpOut>

Computes &self / other.

fn num_ref_div_ref(&self, other: &Self) -> Result<Self::OpOut>

Computes &self / &other.

fn num_rem(self, other: Self) -> Result<Self::OpOut>

Computes self % other.

fn num_rem_ref(self, other: &Self) -> Result<Self::OpOut>

Computes self % &other.

fn num_ref_rem(&self, other: Self) -> Result<Self::OpOut>

Computes &self % other.

fn num_ref_rem_ref(&self, other: &Self) -> Result<Self::OpOut>

Computes &self % &other.

fn num_neg(self) -> Result<Self::OpOut>

Computes - self.

fn num_ref_neg(&self) -> Result<Self::OpOut>

Computes - &self.

fn num_abs(self) -> Result<Self::OpOut>

Computes the absolute value of self.

fn num_ref_abs(&self) -> Result<Self::OpOut>

Computes the absolute value of &self.

impl<const RMIN: i32, const RMAX: i32> Octal for RangeI32<RMIN, RMAX>

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl<const RMIN: i32, const RMAX: i32> Ord for RangeI32<RMIN, RMAX>

fn cmp(&self, other: &RangeI32<RMIN, RMAX>) -> Ordering

This method returns an Ordering between self and other.

fn max(self, other: Self) -> Selfwhere Self: Sized,

Compares and returns the maximum of two values.

fn min(self, other: Self) -> Selfwhere Self: Sized,

Compares and returns the minimum of two values.

fn clamp(self, min: Self, max: Self) -> Selfwhere Self: Sized + PartialOrd,

Restrict a value to a certain interval.

impl<const RMIN: i32, const RMAX: i32> PartialEq for RangeI32<RMIN, RMAX>

fn eq(&self, other: &RangeI32<RMIN, RMAX>) -> bool

This method tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

This method tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl<const RMIN: i32, const RMAX: i32> PartialOrd for RangeI32<RMIN, RMAX>

fn partial_cmp(&self, other: &RangeI32<RMIN, RMAX>) -> Option<Ordering>

This method returns an ordering between self and other values if one exists.

fn lt(&self, other: &Rhs) -> bool

This method tests less than (for self and other) and is used by the < operator.

fn le(&self, other: &Rhs) -> bool

This method tests less than or equal to (for self and other) and is used by the <= operator.

fn gt(&self, other: &Rhs) -> bool

This method tests greater than (for self and other) and is used by the > operator.

fn ge(&self, other: &Rhs) -> bool

This method tests greater than or equal to (for self and other) and is used by the >= operator.

impl<const RMIN: i32, const RMAX: i32> TryFrom<i32> for RangeI32<RMIN, RMAX>

type Error = TryFromIntError

The type returned in the event of a conversion error.

fn try_from(value: i32) -> Result<Self, Self::Error>

Performs the conversion.

impl<const RMIN: i32, const RMAX: i32> UpperHex for RangeI32<RMIN, RMAX>

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl<const RMIN: i32, const RMAX: i32> Copy for RangeI32<RMIN, RMAX>

impl<const RMIN: i32, const RMAX: i32> Eq for RangeI32<RMIN, RMAX>

impl<const RMIN: i32, const RMAX: i32> IntBufAble for RangeI32<RMIN, RMAX>

Available on crate features unsafe_text and text only.

impl<const RMIN: i32, const RMAX: i32> StructuralEq for RangeI32<RMIN, RMAX>

impl<const RMIN: i32, const RMAX: i32> StructuralPartialEq for RangeI32<RMIN, RMAX>