Struct deranged::OptionRangedI128

source ·
pub struct OptionRangedI128<const MIN: i128, const MAX: i128>(/* private fields */);
Expand description

A RangedI128 that is optional. Equivalent to Option<RangedI128> with niche value optimization.

If MIN is i128::MIN and MAX is i128::MAX then compilation will fail. This is because there is no way to represent the niche value.

This type is useful when you need to store an optional ranged value in a struct, but do not want the overhead of an Option type. This reduces the size of the struct overall, and is particularly useful when you have a large number of optional fields. Note that most operations must still be performed on the Option type, which is obtained with OptionRangedI128::get.

Implementations§

source§

impl<const MIN: i128, const MAX: i128> OptionRangedI128<MIN, MAX>

source

pub const None: Self = _

An optional ranged value that is not present.

source

pub const fn Some(value: RangedI128<MIN, MAX>) -> Self

Creates an optional ranged value that is present.

source

pub const fn get(self) -> Option<RangedI128<MIN, MAX>>

Returns the value as the standard library’s Option type.

source

pub const unsafe fn some_unchecked(value: i128) -> Self

Creates an optional ranged integer without checking the value.

§Safety

The value must be within the range MIN..=MAX. As the value used for niche value optimization is unspecified, the provided value must not be the niche value.

source

pub const fn get_primitive(self) -> Option<i128>

source

pub const fn is_none(self) -> bool

Returns true if the value is the niche value.

source

pub const fn is_some(self) -> bool

Returns true if the value is not the niche value.

Trait Implementations§

source§

impl<const MIN: i128, const MAX: i128> Arbitrary for OptionRangedI128<MIN, MAX>

source§

fn arbitrary(g: &mut Gen) -> Self

Return an arbitrary value. Read more
source§

fn shrink(&self) -> Box<dyn Iterator<Item = Self>>

Return an iterator of values that are smaller than itself. Read more
source§

impl<const MIN: i128, const MAX: i128> Clone for OptionRangedI128<MIN, MAX>

source§

fn clone(&self) -> OptionRangedI128<MIN, MAX>

Returns a copy of the value. Read more
1.0.0 · source§

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

Performs copy-assignment from source. Read more
source§

impl<const MIN: i128, const MAX: i128> Debug for OptionRangedI128<MIN, MAX>

source§

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

Formats the value using the given formatter. Read more
source§

impl<const MIN: i128, const MAX: i128> Default for OptionRangedI128<MIN, MAX>

source§

fn default() -> Self

Returns the “default value” for a type. Read more
source§

impl<'de, const MIN: i128, const MAX: i128> Deserialize<'de> for OptionRangedI128<MIN, MAX>

source§

fn deserialize<D: Deserializer<'de>>(deserializer: D) -> Result<Self, D::Error>

Deserialize this value from the given Serde deserializer. Read more
source§

#[doc(hidden)] fn deserialize_in_place<D>( deserializer: D, place: &mut Self, ) -> Result<(), <D as Deserializer<'de>>::Error>
where D: Deserializer<'de>,

Deserializes a value into self from the given Deserializer. Read more
source§

impl<const MIN: i128, const MAX: i128> Distribution<OptionRangedI128<MIN, MAX>> for Standard

source§

fn sample<R: Rng + ?Sized>(&self, rng: &mut R) -> OptionRangedI128<MIN, MAX>

Generate a random value of T, using rng as the source of randomness.
source§

fn sample_iter<R>(self, rng: R) -> DistIter<Self, R, T>
where R: Rng, Self: Sized,

Create an iterator that generates random values of T, using rng as the source of randomness. Read more
source§

fn map<F, S>(self, func: F) -> DistMap<Self, F, T, S>
where F: Fn(T) -> S, Self: Sized,

Create a distribution of values of ‘S’ by mapping the output of Self through the closure F Read more
source§

impl<const MIN: i128, const MAX: i128> Eq for OptionRangedI128<MIN, MAX>

source§

#[doc(hidden)] fn assert_receiver_is_total_eq(&self)

source§

impl<const MIN: i128, const MAX: i128> From<Option<RangedI128<MIN, MAX>>> for OptionRangedI128<MIN, MAX>

source§

fn from(value: Option<RangedI128<MIN, MAX>>) -> Self

Converts to this type from the input type.
source§

impl<const MIN: i128, const MAX: i128> From<OptionRangedI128<MIN, MAX>> for Option<RangedI128<MIN, MAX>>

source§

fn from(value: OptionRangedI128<MIN, MAX>) -> Self

Converts to this type from the input type.
source§

impl<const MIN: i128, const MAX: i128> From<RangedI128<MIN, MAX>> for OptionRangedI128<MIN, MAX>

source§

fn from(value: RangedI128<MIN, MAX>) -> Self

Converts to this type from the input type.
source§

impl<const MIN: i128, const MAX: i128> Hash for OptionRangedI128<MIN, MAX>

source§

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

Feeds this value into the given Hasher. Read more
1.3.0 · source§

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

Feeds a slice of this type into the given Hasher. Read more
source§

impl<const MIN: i128, const MAX: i128> Ord for OptionRangedI128<MIN, MAX>

source§

fn cmp(&self, other: &Self) -> Ordering

This method returns an Ordering between self and other. Read more
1.21.0 · source§

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

Compares and returns the maximum of two values. Read more
1.21.0 · source§

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

Compares and returns the minimum of two values. Read more
1.50.0 · source§

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

Restrict a value to a certain interval. Read more
source§

impl<const MIN_A: i128, const MAX_A: i128, const MIN_B: i128, const MAX_B: i128> PartialEq<OptionRangedI128<MIN_B, MAX_B>> for OptionRangedI128<MIN_A, MAX_A>

source§

fn eq(&self, other: &OptionRangedI128<MIN_B, MAX_B>) -> bool

Tests for self and other values to be equal, and is used by ==.
1.0.0 · source§

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

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.
source§

impl<const MIN_A: i128, const MAX_A: i128, const MIN_B: i128, const MAX_B: i128> PartialOrd<OptionRangedI128<MIN_B, MAX_B>> for OptionRangedI128<MIN_A, MAX_A>

source§

fn partial_cmp( &self, other: &OptionRangedI128<MIN_B, MAX_B>, ) -> Option<Ordering>

This method returns an ordering between self and other values if one exists. Read more
1.0.0 · source§

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

Tests less than (for self and other) and is used by the < operator. Read more
1.0.0 · source§

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

Tests less than or equal to (for self and other) and is used by the <= operator. Read more
1.0.0 · source§

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

Tests greater than (for self and other) and is used by the > operator. Read more
1.0.0 · source§

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

Tests greater than or equal to (for self and other) and is used by the >= operator. Read more
source§

impl<const MIN: i128, const MAX: i128> Serialize for OptionRangedI128<MIN, MAX>

source§

fn serialize<S: Serializer>(&self, serializer: S) -> Result<S::Ok, S::Error>

Serialize this value into the given Serde serializer. Read more
source§

impl<const MIN: i128, const MAX: i128> Copy for OptionRangedI128<MIN, MAX>

Auto Trait Implementations§

§

impl<const MIN: i128, const MAX: i128> Freeze for OptionRangedI128<MIN, MAX>

§

impl<const MIN: i128, const MAX: i128> RefUnwindSafe for OptionRangedI128<MIN, MAX>

§

impl<const MIN: i128, const MAX: i128> Send for OptionRangedI128<MIN, MAX>

§

impl<const MIN: i128, const MAX: i128> Sync for OptionRangedI128<MIN, MAX>

§

impl<const MIN: i128, const MAX: i128> Unpin for OptionRangedI128<MIN, MAX>

§

impl<const MIN: i128, const MAX: i128> UnwindSafe for OptionRangedI128<MIN, MAX>

Blanket Implementations§

source§

impl<T> Any for T
where T: 'static + ?Sized,

source§

fn type_id(&self) -> TypeId

Gets the TypeId of self. Read more
source§

impl<T> Borrow<T> for T
where T: ?Sized,

source§

fn borrow(&self) -> &T

Immutably borrows from an owned value. Read more
source§

impl<T> BorrowMut<T> for T
where T: ?Sized,

source§

fn borrow_mut(&mut self) -> &mut T

Mutably borrows from an owned value. Read more
source§

impl<T> CloneToUninit for T
where T: Clone,

source§

unsafe fn clone_to_uninit(&self, dst: *mut T)

🔬This is a nightly-only experimental API. (clone_to_uninit)
Performs copy-assignment from self to dst. Read more
source§

impl<T> From<T> for T

source§

fn from(t: T) -> T

Returns the argument unchanged.

source§

impl<T, U> Into<U> for T
where U: From<T>,

source§

fn into(self) -> U

Calls U::from(self).

That is, this conversion is whatever the implementation of From<T> for U chooses to do.

source§

impl<T> SizedTypeProperties for T

source§

#[doc(hidden)] const IS_ZST: bool = _

🔬This is a nightly-only experimental API. (sized_type_properties)
true if this type requires no storage. false if its size is greater than zero. Read more
source§

#[doc(hidden)] const LAYOUT: Layout = _

🔬This is a nightly-only experimental API. (sized_type_properties)
source§

impl<T> ToOwned for T
where T: Clone,

source§

type Owned = T

The resulting type after obtaining ownership.
source§

fn to_owned(&self) -> T

Creates owned data from borrowed data, usually by cloning. Read more
source§

fn clone_into(&self, target: &mut T)

Uses borrowed data to replace owned data, usually by cloning. Read more
source§

impl<T, U> TryFrom<U> for T
where U: Into<T>,

source§

type Error = Infallible

The type returned in the event of a conversion error.
source§

fn try_from(value: U) -> Result<T, <T as TryFrom<U>>::Error>

Performs the conversion.
source§

impl<T, U> TryInto<U> for T
where U: TryFrom<T>,

source§

type Error = <U as TryFrom<T>>::Error

The type returned in the event of a conversion error.
source§

fn try_into(self) -> Result<U, <U as TryFrom<T>>::Error>

Performs the conversion.
source§

impl<T> DeserializeOwned for T
where T: for<'de> Deserialize<'de>,

source§

impl<T> Printable for T
where T: Copy + Debug,

source§

impl<T> TyCompat<Maybe> for T
where T: ?Sized,

source§

impl<T> TyCompat<T> for T
where T: ?Sized,