Struct PositiveI8

#[repr(C, align(1))]
pub struct PositiveI8 { /* private fields */ }

A signed value that is known to be positive.

This enables some memory layout optimization. For example, Option<PositiveI8> is the same size as i8.

Implementations

impl PositiveI8

pub const BITS: u32 = 8u32

The size of this positive integer type in bits.

This value is equal to i8::BITS.

pub const MIN: Self = _

The smallest value that can be represented by this positive integer type, 0.

pub const MAX: Self = _

The largest value that can be represented by this positive integer type, equal to i8::MAX.

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

Creates a PositiveI8 if the given value is positive.

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

Creates a PositiveI8 without checking whether the value is positive. This results in undefined behaviour if the value is negative.

Safety

The value must not be negative.

pub const fn get(self) -> i8

Returns the contained value as a primitive type.

pub const fn count_zeros(self) -> u32

Returns the number of zeros in the binary representation of self.

pub const fn count_ones(self) -> u32

Returns the number of ones in the binary representation of self.

pub const fn leading_zeros(self) -> u32

Returns the number of leading zeros in the binary representation of self.

pub const fn trailing_zeros(self) -> u32

Returns the number of trailing zeros in the binary representation of self.

pub const fn is_power_of_two(self) -> bool

Returns true if and only if self == (1 << k) for some k.

pub const fn ilog2(self) -> u32

Returns the base 2 logarithm of the number, rounded down.

Panics

This function will panic if self is zero.

pub const fn ilog10(self) -> u32

Returns the base 10 logarithm of the number, rounded down.

Panics

This function will panic if self is zero.

pub const fn checked_neg(self) -> Option<NegativeI8>

Checked negation. Computes -self, returning None if self == 0.

pub const fn checked_add(self, rhs: Self) -> Option<Self>

Checked addition. Adds a positive integer to another positive integer. Checks for overflow and returns None on overflow. As a consequence, the result cannot wrap to a negative integer.

pub const fn checked_sub(self, rhs: Self) -> Option<Self>

Checked subtraction. Subtracts a positive integer from another positive integer. Returns None if the result would overflow into a negative integer.

pub const fn checked_mul(self, rhs: Self) -> Option<Self>

Checked multiplication. Multiplies a positive integer by another positive integer, returning a positive result. Returns None if the result would overflow.

pub const fn checked_div(self, rhs: Self) -> Option<Self>

Checked division. Divides a positive integer by another positive integer, returning the positive quotient. Returns None if rhs == 0.

pub const fn checked_rem(self, rhs: Self) -> Option<Self>

Checked remainder. Divides a positive integer by another positive integer, returning the positive remainder. Returns None if rhs == 0.

pub const fn checked_div_unsigned(self, rhs: u8) -> Option<Self>

Checked division by unsigned. Divides a positive integer by an unsigned integer, returning the positive quotient. Returns None if rhs == 0.

pub const fn checked_rem_unsigned(self, rhs: u8) -> Option<Self>

Checked remainder of unsigned. Divides a positive integer by an unsigned integer, returning the positive remainder. Returns None if rhs == 0.

pub const fn checked_pow(self, rhs: u32) -> Option<Self>

Checked integer exponentiation. Raises positive value to an integer power. Checks for overflow and returns None on overflow. As a consequence, the result cannot wrap to a negative integer.

pub const fn checked_next_power_of_two(self) -> Option<Self>

Returns the smallest power of two greater than or equal to self. Checks for overflow and returns None if the next power of two is greater than the type’s maximum value. As a consequence, the result cannot wrap to a negative integer.

pub const fn checked_ilog2(self) -> Option<u32>

Returns the base 2 logarithm of the number, rounded down.

Returns None if the number is zero.

pub const fn checked_ilog10(self) -> Option<u32>

Returns the base 10 logarithm of the number, rounded down.

Returns None if the number is zero.

pub const fn saturating_add(self, rhs: Self) -> Self

Saturating addition. Adds a positive integer to another positive integer. Returns PositiveI8::MAX on overflow.

pub const fn saturating_sub(self, rhs: Self) -> Self

Saturating subtraction. Subtracts a positive integer from another positive integer. Returns 0 if the result would overflow into a negative integer.

pub const fn saturating_mul(self, rhs: Self) -> Self

Saturating multiplication. Multiplies a positive integer by another positive integer, returning a positive result. Returns PositiveI8::MAX on overflow.

pub const fn saturating_pow(self, rhs: u32) -> Self

Saturating integer exponentiation. Raises positive value to an integer power. Returns PositiveI8::MAX on overflow.

Trait Implementations

impl Binary for PositiveI8

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

Formats the value using the given formatter.

impl BitAnd<NegativeI8> for PositiveI8

type Output = PositiveI8

The resulting type after applying the & operator.

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

Performs the & operation.

impl BitAnd<PositiveI8> for NegativeI8

type Output = PositiveI8

The resulting type after applying the & operator.

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

Performs the & operation.

impl BitAnd<PositiveI8> for i8

type Output = PositiveI8

The resulting type after applying the & operator.

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

Performs the & operation.

impl BitAnd<i8> for PositiveI8

type Output = PositiveI8

The resulting type after applying the & operator.

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

Performs the & operation.

impl BitAnd for PositiveI8

type Output = PositiveI8

The resulting type after applying the & operator.

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

Performs the & operation.

impl BitAndAssign<NegativeI8> for PositiveI8

fn bitand_assign(&mut self, rhs: NegativeI8)

Performs the &= operation.

impl BitAndAssign<i8> for PositiveI8

fn bitand_assign(&mut self, rhs: i8)

Performs the &= operation.

impl BitAndAssign for PositiveI8

fn bitand_assign(&mut self, rhs: Self)

Performs the &= operation.

impl BitOr<NegativeI8> for PositiveI8

type Output = NegativeI8

The resulting type after applying the | operator.

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

Performs the | operation.

impl BitOr<PositiveI8> for NegativeI8

type Output = NegativeI8

The resulting type after applying the | operator.

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

Performs the | operation.

impl BitOr for PositiveI8

type Output = PositiveI8

The resulting type after applying the | operator.

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

Performs the | operation.

impl BitOrAssign<PositiveI8> for NegativeI8

fn bitor_assign(&mut self, rhs: PositiveI8)

Performs the |= operation.

impl BitOrAssign for PositiveI8

fn bitor_assign(&mut self, rhs: Self)

Performs the |= operation.

impl BitXor<NegativeI8> for PositiveI8

type Output = NegativeI8

The resulting type after applying the ^ operator.

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

Performs the ^ operation.

impl BitXor<PositiveI8> for NegativeI8

type Output = NegativeI8

The resulting type after applying the ^ operator.

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

Performs the ^ operation.

impl BitXor for PositiveI8

type Output = PositiveI8

The resulting type after applying the ^ operator.

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

Performs the ^ operation.

impl BitXorAssign<PositiveI8> for NegativeI8

fn bitxor_assign(&mut self, rhs: PositiveI8)

Performs the ^= operation.

impl BitXorAssign for PositiveI8

fn bitxor_assign(&mut self, rhs: Self)

Performs the ^= operation.

impl Clone for PositiveI8

fn clone(&self) -> PositiveI8

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Debug for PositiveI8

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

Formats the value using the given formatter.

impl Default for PositiveI8

fn default() -> Self

Returns the “default value” for a type.

impl Display for PositiveI8

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

Formats the value using the given formatter.

impl Div<u8> for PositiveI8

type Output = PositiveI8

The resulting type after applying the / operator.

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

Performs the / operation.

impl Div for PositiveI8

type Output = PositiveI8

The resulting type after applying the / operator.

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

Performs the / operation.

impl DivAssign<u8> for PositiveI8

fn div_assign(&mut self, rhs: u8)

Performs the /= operation.

impl DivAssign for PositiveI8

fn div_assign(&mut self, rhs: Self)

Performs the /= operation.

impl From<PositiveI8> for PositiveI16

fn from(value: PositiveI8) -> Self

Converts to this type from the input type.

impl From<PositiveI8> for PositiveI32

fn from(value: PositiveI8) -> Self

Converts to this type from the input type.

impl From<PositiveI8> for PositiveI64

fn from(value: PositiveI8) -> Self

Converts to this type from the input type.

impl From<PositiveI8> for PositiveIsize

fn from(value: PositiveI8) -> Self

Converts to this type from the input type.

impl From<PositiveI8> for i128

fn from(value: PositiveI8) -> Self

Converts to this type from the input type.

impl From<PositiveI8> for i16

fn from(value: PositiveI8) -> Self

Converts to this type from the input type.

impl From<PositiveI8> for i32

fn from(value: PositiveI8) -> Self

Converts to this type from the input type.

impl From<PositiveI8> for i64

fn from(value: PositiveI8) -> Self

Converts to this type from the input type.

impl From<PositiveI8> for i8

fn from(value: PositiveI8) -> Self

Converts to this type from the input type.

impl From<PositiveI8> for isize

fn from(value: PositiveI8) -> Self

Converts to this type from the input type.

impl From<PositiveI8> for u128

fn from(value: PositiveI8) -> Self

Converts to this type from the input type.

impl From<PositiveI8> for u16

fn from(value: PositiveI8) -> Self

Converts to this type from the input type.

impl From<PositiveI8> for u32

fn from(value: PositiveI8) -> Self

Converts to this type from the input type.

impl From<PositiveI8> for u64

fn from(value: PositiveI8) -> Self

Converts to this type from the input type.

impl From<PositiveI8> for u8

fn from(value: PositiveI8) -> Self

Converts to this type from the input type.

impl From<PositiveI8> for usize

fn from(value: PositiveI8) -> Self

Converts to this type from the input type.

impl FromStr for PositiveI8

type Err = IntErrorKind

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 PositiveI8

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 LowerHex for PositiveI8

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

Formats the value using the given formatter.

impl Not for PositiveI8

type Output = NegativeI8

The resulting type after applying the ! operator.

fn not(self) -> Self::Output

Performs the unary ! operation.

impl Octal for PositiveI8

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

Formats the value using the given formatter.

impl Ord for PositiveI8

fn cmp(&self, rhs: &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,

Restrict a value to a certain interval.

impl PartialEq for PositiveI8

fn eq(&self, rhs: &Self) -> bool

Tests for self and other values to be equal, and is used by ==.

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

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

impl PartialOrd for PositiveI8

fn partial_cmp(&self, rhs: &Self) -> Option<Ordering>

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

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

Tests less than (for self and other) and is used by the < operator.

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

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

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

Tests greater than (for self and other) and is used by the > operator.

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

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

impl Rem<u8> for PositiveI8

type Output = PositiveI8

The resulting type after applying the % operator.

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

Performs the % operation.

impl Rem for PositiveI8

type Output = PositiveI8

The resulting type after applying the % operator.

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

Performs the % operation.

impl RemAssign<u8> for PositiveI8

fn rem_assign(&mut self, rhs: u8)

Performs the %= operation.

impl RemAssign for PositiveI8

fn rem_assign(&mut self, rhs: Self)

Performs the %= operation.

impl TryFrom<PositiveI16> for PositiveI8

type Error = TryFromIntError

The type returned in the event of a conversion error.

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

Performs the conversion.

impl TryFrom<PositiveI32> for PositiveI8

type Error = TryFromIntError

The type returned in the event of a conversion error.

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

Performs the conversion.

impl TryFrom<PositiveI64> for PositiveI8

type Error = TryFromIntError

The type returned in the event of a conversion error.

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

Performs the conversion.

impl TryFrom<PositiveIsize> for PositiveI8

type Error = TryFromIntError

The type returned in the event of a conversion error.

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

Performs the conversion.

impl TryFrom<i128> for PositiveI8

type Error = TryFromIntError

The type returned in the event of a conversion error.

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

Performs the conversion.

impl TryFrom<i16> for PositiveI8

type Error = TryFromIntError

The type returned in the event of a conversion error.

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

Performs the conversion.

impl TryFrom<i32> for PositiveI8

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 TryFrom<i64> for PositiveI8

type Error = TryFromIntError

The type returned in the event of a conversion error.

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

Performs the conversion.

impl TryFrom<i8> for PositiveI8

type Error = TryFromIntError

The type returned in the event of a conversion error.

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

Performs the conversion.

impl TryFrom<isize> for PositiveI8

type Error = TryFromIntError

The type returned in the event of a conversion error.

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

Performs the conversion.

impl TryFrom<u128> for PositiveI8

type Error = TryFromIntError

The type returned in the event of a conversion error.

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

Performs the conversion.

impl TryFrom<u16> for PositiveI8

type Error = TryFromIntError

The type returned in the event of a conversion error.

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

Performs the conversion.

impl TryFrom<u32> for PositiveI8

type Error = TryFromIntError

The type returned in the event of a conversion error.

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

Performs the conversion.

impl TryFrom<u64> for PositiveI8

type Error = TryFromIntError

The type returned in the event of a conversion error.

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

Performs the conversion.

impl TryFrom<u8> for PositiveI8

type Error = TryFromIntError

The type returned in the event of a conversion error.

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

Performs the conversion.

impl TryFrom<usize> for PositiveI8

type Error = TryFromIntError

The type returned in the event of a conversion error.

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

Performs the conversion.

impl UpperHex for PositiveI8

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

Formats the value using the given formatter.

impl Copy for PositiveI8

impl Eq for PositiveI8