Struct deranged::OptionRangedUsize

#[repr(transparent)]
pub struct OptionRangedUsize<const MIN: usize, const MAX: usize>(pub(crate) usize);

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

If MIN is usize::MIN and MAX is usize::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 OptionRangedUsize::get.

Tuple Fields

0: usize

Implementations

impl<const MIN: usize, const MAX: usize> OptionRangedUsize<MIN, MAX>

pub(crate) const NICHE: usize = _

The value used as the niche. Must not be in the range MIN..=MAX.

pub const None: Self = _

An optional ranged value that is not present.

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

Creates an optional ranged value that is present.

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

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

pub const unsafe fn some_unchecked(value: usize) -> 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.

pub(crate) const fn inner(self) -> usize

Obtain the inner value of the struct. This is useful for comparisons.

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

pub const fn is_none(self) -> bool

Returns true if the value is the niche value.

pub const fn is_some(self) -> bool

Returns true if the value is not the niche value.

Trait Implementations

impl<const MIN: usize, const MAX: usize> Clone for OptionRangedUsize<MIN, MAX>

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

Returns a copy of the value.

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

Performs copy-assignment from source.

impl<const MIN: usize, const MAX: usize> Debug for OptionRangedUsize<MIN, MAX>

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

Formats the value using the given formatter.

impl<const MIN: usize, const MAX: usize> Default for OptionRangedUsize<MIN, MAX>

fn default() -> Self

Returns the “default value” for a type.

impl<'de, const MIN: usize, const MAX: usize> Deserialize<'de> for OptionRangedUsize<MIN, MAX>

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

Deserialize this value from the given Serde deserializer.

impl<const MIN: usize, const MAX: usize> From<Option<RangedUsize<MIN, MAX>>> for OptionRangedUsize<MIN, MAX>

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

Converts to this type from the input type.

impl<const MIN: usize, const MAX: usize> From<OptionRangedUsize<MIN, MAX>> for Option<RangedUsize<MIN, MAX>>

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

Converts to this type from the input type.

impl<const MIN: usize, const MAX: usize> From<RangedUsize<MIN, MAX>> for OptionRangedUsize<MIN, MAX>

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

Converts to this type from the input type.

impl<const MIN: usize, const MAX: usize> Hash for OptionRangedUsize<MIN, MAX>

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 MIN: usize, const MAX: usize> Ord for OptionRangedUsize<MIN, MAX>

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

This method returns an Ordering between self and other.

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

where Self: Sized,

Compares and returns the maximum of two values.

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

where Self: Sized,

Compares and returns the minimum of two values.

fn clamp(self, min: Self, max: Self) -> Self

where Self: Sized + PartialOrd,

Restrict a value to a certain interval.

impl<const MIN_A: usize, const MAX_A: usize, const MIN_B: usize, const MAX_B: usize> PartialEq<OptionRangedUsize<MIN_B, MAX_B>> for OptionRangedUsize<MIN_A, MAX_A>

fn eq(&self, other: &OptionRangedUsize<MIN_B, MAX_B>) -> 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 MIN_A: usize, const MAX_A: usize, const MIN_B: usize, const MAX_B: usize> PartialOrd<OptionRangedUsize<MIN_B, MAX_B>> for OptionRangedUsize<MIN_A, MAX_A>

fn partial_cmp( &self, other: &OptionRangedUsize<MIN_B, MAX_B>, ) -> 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 MIN: usize, const MAX: usize> Serialize for OptionRangedUsize<MIN, MAX>

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

Serialize this value into the given Serde serializer.

impl<const MIN: usize, const MAX: usize> Copy for OptionRangedUsize<MIN, MAX>

impl<const MIN: usize, const MAX: usize> Eq for OptionRangedUsize<MIN, MAX>