Struct amplify_num::u24

pub struct u24(_);

24-bit unsigned integer in the range 0..16_777_216

Implementations

impl u24

pub const BITS: u32 = 24u32

Bit dimension

pub const MIN: Self = Self(0)

Minimum value

pub const MAX: Self = Self((1u32 << 24) - 1)

Maximal value

pub const ONE: Self = Self(1)

One value

pub const ZERO: Self = Self(0)

One value

pub fn with(value: u32) -> Self

Creates a new value from a provided `value.

Panics if the value exceeds Self::MAX

pub fn as_u32(self) -> u32

Returns inner u8 representation, which is always less or equal to Self::MAX

impl u24

pub fn checked_add<T>(self, rhs: T) -> Option<Self> where
    T: Into<u32>, 

Checked integer addition. Computes self + rhs, returning None if overflow occurred.

pub fn saturating_add<T>(self, rhs: T) -> Self where
    T: Into<u32>, 

Saturating integer addition. Computes self + rhs, saturating at the numeric bounds instead of overflowing.

pub fn overflowing_add<T>(self, rhs: T) -> (Self, bool) where
    T: Into<u32>, 

Calculates self + rhs

Returns a tuple of the addition along with a boolean indicating whether an arithmetic overflow would occur. If an overflow would have occurred then the wrapped value is returned.

pub fn wrapping_add<T>(self, rhs: T) -> Self where
    T: Into<u32>, 

Wrapping (modular) addition. Computes self + rhs, wrapping around at the boundary of the type.

pub fn checked_sub<T>(self, rhs: T) -> Option<Self> where
    T: Into<u32>, 

Checked integer subtraction. Computes self - rhs, returning None if overflow occurred.

pub fn saturating_sub<T>(self, rhs: T) -> Self where
    T: Into<u32>, 

Saturating integer subtraction. Computes self - rhs, saturating at the numeric bounds instead of overflowing.

pub fn overflowing_sub<T>(self, rhs: T) -> (Self, bool) where
    T: Into<u32>, 

Calculates self - rhs

Returns a tuple of the subtraction along with a boolean indicating whether an arithmetic overflow would occur. If an overflow would have occurred then the wrapped value is returned.

pub fn wrapping_sub<T>(self, rhs: T) -> Self where
    T: Into<u32>, 

Wrapping (modular) subtraction. Computes self - rhs, wrapping around at the boundary of the type.

pub fn checked_mul<T>(self, rhs: T) -> Option<Self> where
    T: Into<u32>, 

Checked integer multiplication. Computes self * rhs, returning None if overflow occurred.

pub fn saturating_mul<T>(self, rhs: T) -> Self where
    T: Into<u32>, 

Saturating integer multiplication. Computes self * rhs, saturating at the numeric bounds instead of overflowing.

pub fn overflowing_mul<T>(self, rhs: T) -> (Self, bool) where
    T: Into<u32>, 

Calculates self * rhs

Returns a tuple of the multiplication along with a boolean indicating whether an arithmetic overflow would occur. If an overflow would have occurred then the wrapped value is returned.

pub fn wrapping_mul<T>(self, rhs: T) -> Self where
    T: Into<u32>, 

Wrapping (modular) multiplication. Computes self * rhs, wrapping around at the boundary of the type.

pub fn div_rem(self, other: Self) -> Result<(Self, Self), DivError>

impl u24

pub fn from_le_bytes(bytes: [u8; 3]) -> u24

Create a native endian integer value from its representation as a byte array in little endian.

pub fn to_le_bytes(self) -> [u8; 3]

Return the memory representation of this integer as a byte array in little-endian byte order.

pub fn from_be_bytes(bytes: [u8; 3]) -> u24

Create a native endian integer value from its representation as a byte array in big endian.

pub fn to_be_bytes(self) -> [u8; 3]

Return the memory representation of this integer as a byte array in big-endian byte order.

pub fn into_i32(self) -> i32

Converts into i32 type.

pub fn into_i64(self) -> i64

Converts into i64 type.

pub fn into_isize(self) -> isize

Converts into isize type.

pub fn into_u32(self) -> u32

Converts into u32 type.

pub fn into_u64(self) -> u64

Converts into u64 type.

pub fn into_usize(self) -> usize

Converts into usize type.

Trait Implementations

impl<T> Add<T> for u24 where
    T: Into<u32>, 

type Output = u24

The resulting type after applying the + operator.

fn add(self, rhs: T) -> Self::Output

Performs the + operation.

impl<T> Add<T> for &u24 where
    T: Into<u32>, 

type Output = u24

The resulting type after applying the + operator.

fn add(self, rhs: T) -> Self::Output

Performs the + operation.

impl<T> AddAssign<T> for u24 where
    T: Into<u32>, 

fn add_assign(&mut self, rhs: T)

Performs the += operation.

impl AsRef<u32> for u24

fn as_ref(&self) -> &u32

Converts this type into a shared reference of the (usually inferred) input type.

impl Binary for u24

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

Formats the value using the given formatter.

impl<T> BitAnd<T> for u24 where
    T: Into<u32>, 

type Output = u24

The resulting type after applying the & operator.

fn bitand(self, rhs: T) -> Self::Output

Performs the & operation.

impl<T> BitAnd<T> for &u24 where
    T: Into<u32>, 

type Output = u24

The resulting type after applying the & operator.

fn bitand(self, rhs: T) -> Self::Output

Performs the & operation.

impl<T> BitAndAssign<T> for u24 where
    T: Into<u32>, 

fn bitand_assign(&mut self, rhs: T)

Performs the &= operation.

impl<T> BitOr<T> for u24 where
    T: Into<u32>, 

type Output = u24

The resulting type after applying the | operator.

fn bitor(self, rhs: T) -> Self::Output

Performs the | operation.

impl<T> BitOr<T> for &u24 where
    T: Into<u32>, 

type Output = u24

The resulting type after applying the | operator.

fn bitor(self, rhs: T) -> Self::Output

Performs the | operation.

impl<T> BitOrAssign<T> for u24 where
    T: Into<u32>, 

fn bitor_assign(&mut self, rhs: T)

Performs the |= operation.

impl<T> BitXor<T> for u24 where
    T: Into<u32>, 

type Output = u24

The resulting type after applying the ^ operator.

fn bitxor(self, rhs: T) -> Self::Output

Performs the ^ operation.

impl<T> BitXor<T> for &u24 where
    T: Into<u32>, 

type Output = u24

The resulting type after applying the ^ operator.

fn bitxor(self, rhs: T) -> Self::Output

Performs the ^ operation.

impl<T> BitXorAssign<T> for u24 where
    T: Into<u32>, 

fn bitxor_assign(&mut self, rhs: T)

Performs the ^= operation.

impl Clone for u24

fn clone(&self) -> u24

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Debug for u24

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

Formats the value using the given formatter.

impl Default for u24

fn default() -> u24

Returns the “default value” for a type.

impl Display for u24

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

Formats the value using the given formatter.

impl<T> Div<T> for u24 where
    T: Into<u32>, 

type Output = u24

The resulting type after applying the / operator.

fn div(self, rhs: T) -> Self::Output

Performs the / operation.

impl<T> Div<T> for &u24 where
    T: Into<u32>, 

type Output = u24

The resulting type after applying the / operator.

fn div(self, rhs: T) -> Self::Output

Performs the / operation.

impl<T> DivAssign<T> for u24 where
    T: Into<u32>, 

fn div_assign(&mut self, rhs: T)

Performs the /= operation.

impl From<u24> for u32

fn from(val: u24) -> Self

Converts to this type from the input type.

impl From<u24> for i32

fn from(val: u24) -> Self

Converts to this type from the input type.

impl From<u24> for i64

fn from(val: u24) -> Self

Converts to this type from the input type.

impl From<u24> for isize

fn from(val: u24) -> Self

Converts to this type from the input type.

impl From<u24> for u64

fn from(val: u24) -> Self

Converts to this type from the input type.

impl From<u24> for usize

fn from(val: u24) -> Self

Converts to this type from the input type.

impl FromStr for u24

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 Hash for u24

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, 

Feeds a slice of this type into the given Hasher.

impl LowerHex for u24

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

Formats the value using the given formatter.

impl<T> Mul<T> for u24 where
    T: Into<u32>, 

type Output = u24

The resulting type after applying the * operator.

fn mul(self, rhs: T) -> Self::Output

Performs the * operation.

impl<T> Mul<T> for &u24 where
    T: Into<u32>, 

type Output = u24

The resulting type after applying the * operator.

fn mul(self, rhs: T) -> Self::Output

Performs the * operation.

impl<T> MulAssign<T> for u24 where
    T: Into<u32>, 

fn mul_assign(&mut self, rhs: T)

Performs the *= operation.

impl Octal for u24

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

Formats the value using the given formatter.

impl Ord for u24

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

This method returns an Ordering between self and other.

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

Compares and returns the maximum of two values.

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

Compares and returns the minimum of two values.

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

Restrict a value to a certain interval.

impl PartialEq<u24> for u24

fn eq(&self, other: &u24) -> bool

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

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

This method tests for !=.

impl PartialOrd<u24> for u24

fn partial_cmp(&self, other: &u24) -> 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<T> Rem<T> for u24 where
    T: Into<u32>, 

type Output = u24

The resulting type after applying the % operator.

fn rem(self, rhs: T) -> Self::Output

Performs the % operation.

impl<T> Rem<T> for &u24 where
    T: Into<u32>, 

type Output = u24

The resulting type after applying the % operator.

fn rem(self, rhs: T) -> Self::Output

Performs the % operation.

impl<T> RemAssign<T> for u24 where
    T: Into<u32>, 

fn rem_assign(&mut self, rhs: T)

Performs the %= operation.

impl<T> Shl<T> for u24 where
    T: Into<u32>, 

type Output = u24

The resulting type after applying the << operator.

fn shl(self, rhs: T) -> Self::Output

Performs the << operation.

impl<T> Shl<T> for &u24 where
    T: Into<u32>, 

type Output = u24

The resulting type after applying the << operator.

fn shl(self, rhs: T) -> Self::Output

Performs the << operation.

impl<T> ShlAssign<T> for u24 where
    T: Into<u32>, 

fn shl_assign(&mut self, rhs: T)

Performs the <<= operation.

impl<T> Shr<T> for u24 where
    T: Into<u32>, 

type Output = u24

The resulting type after applying the >> operator.

fn shr(self, rhs: T) -> Self::Output

Performs the >> operation.

impl<T> Shr<T> for &u24 where
    T: Into<u32>, 

type Output = u24

The resulting type after applying the >> operator.

fn shr(self, rhs: T) -> Self::Output

Performs the >> operation.

impl<T> ShrAssign<T> for u24 where
    T: Into<u32>, 

fn shr_assign(&mut self, rhs: T)

Performs the >>= operation.

impl<T> Sub<T> for u24 where
    T: Into<u32>, 

type Output = u24

The resulting type after applying the - operator.

fn sub(self, rhs: T) -> Self::Output

Performs the - operation.

impl<T> Sub<T> for &u24 where
    T: Into<u32>, 

type Output = u24

The resulting type after applying the - operator.

fn sub(self, rhs: T) -> Self::Output

Performs the - operation.

impl<T> SubAssign<T> for u24 where
    T: Into<u32>, 

fn sub_assign(&mut self, rhs: T)

Performs the -= operation.

impl TryFrom<u32> for u24

type Error = OverflowError

The type returned in the event of a conversion error.

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

Performs the conversion.

impl UpperHex for u24

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

Formats the value using the given formatter.

impl Copy for u24

impl Eq for u24

impl StructuralEq for u24

impl StructuralPartialEq for u24