Struct sp_runtime::Fixed128

pub struct Fixed128(_);

Re-export top-level arithmetic stuff. A signed fixed-point number. Can hold any value in the range [-170_141_183_460_469_231_731, 170_141_183_460_469_231_731] with fixed-point accuracy of 10 ** 18.

Methods

impl Fixed128

Re-export top-level arithmetic stuff.

pub fn from_natural(int: i128) -> Fixed128

Create self from a natural number.

Note that this might be lossy.

pub const fn accuracy() -> i128

Accuracy of Fixed128.

pub const fn from_parts(parts: i128) -> Fixed128

Raw constructor. Equal to parts / DIV.

pub fn from_rational<N>(n: N, d: NonZeroI128) -> Fixed128 where
    N: UniqueSaturatedInto<i128>, 

Creates self from a rational number. Equal to n/d.

Note that this might be lossy. Only use this if you are sure that n * DIV can fit into an i128.

pub fn deconstruct(self) -> i128

Consume self and return the inner raw i128 value.

Note this is a low level function, as the returned value is represented with accuracy.

pub fn recip(&self) -> Option<Fixed128>

Takes the reciprocal(inverse) of Fixed128, 1/x

pub fn checked_add(&self, rhs: &Fixed128) -> Option<Fixed128>

Checked add. Same semantic to num_traits::CheckedAdd.

pub fn checked_sub(&self, rhs: &Fixed128) -> Option<Fixed128>

Checked sub. Same semantic to num_traits::CheckedSub.

pub fn checked_mul(&self, rhs: &Fixed128) -> Option<Fixed128>

Checked mul. Same semantic to num_traits::CheckedMul.

pub fn checked_div(&self, rhs: &Fixed128) -> Option<Fixed128>

Checked div. Same semantic to num_traits::CheckedDiv.

pub fn checked_mul_int<N>(&self, other: &N) -> Option<N> where
    N: Copy + TryFrom<i128> + TryInto<i128>, 

Checked mul for int type N.

pub fn saturating_mul_int<N>(&self, other: &N) -> N where
    N: Copy + TryFrom<i128> + TryInto<i128> + Bounded, 

Checked mul for int type N.

pub fn checked_div_int<N>(&self, other: &N) -> Option<N> where
    N: Copy + TryFrom<i128> + TryInto<i128>, 

Checked div for int type N.

pub fn zero() -> Fixed128

pub fn is_zero(&self) -> bool

pub fn saturating_abs(&self) -> Fixed128

Saturating absolute value. Returning MAX if parts == i128::MIN instead of overflowing.

pub fn is_positive(&self) -> bool

pub fn is_negative(&self) -> bool

pub fn saturated_multiply_accumulate<N>(self, int: N) -> N where
    N: TryFrom<u128> + From<u64> + UniqueSaturatedInto<u64> + Bounded + Clone + Saturating + Rem<N, Output = N> + Div<N, Output = N> + Mul<N, Output = N> + Add<N, Output = N>, 

Performs a saturated multiply and accumulate by unsigned number.

Returns a saturated int + (self * int).

Trait Implementations

impl Add<Fixed128> for Fixed128

Note that this is a standard, potentially-panicking, implementation. Use Saturating trait for safe addition.

type Output = Fixed128

The resulting type after applying the + operator.

fn add(self, rhs: Fixed128) -> <Fixed128 as Add<Fixed128>>::Output

Performs the + operation.

impl Bounded for Fixed128

fn min_value() -> Fixed128

returns the smallest finite number this type can represent

fn max_value() -> Fixed128

returns the largest finite number this type can represent

impl Clone for Fixed128

fn clone(&self) -> Fixed128

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Copy for Fixed128

impl Debug for Fixed128

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

Formats the value using the given formatter.

impl Decode for Fixed128

fn decode<DecIn>(input: &mut DecIn) -> Result<Fixed128, Error> where
    DecIn: Input, 

Attempt to deserialise the value from input.

impl Default for Fixed128

fn default() -> Fixed128

Returns the "default value" for a type.

impl<'de> Deserialize<'de> for Fixed128

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

Deserialize this value from the given Serde deserializer.

impl Encode for Fixed128

fn encode_to<EncOut>(&self, dest: &mut EncOut) where
    EncOut: Output, 

Convert self to a slice and append it to the destination.

fn encode(&self) -> Vec<u8>

Convert self to an owned vector.

fn using_encoded<R, F>(&self, f: F) -> R where
    F: FnOnce(&[u8]) -> R, 

Convert self to a slice and then invoke the given closure with it.

fn size_hint(&self) -> usize

If possible give a hint of expected size of the encoding.

impl EncodeLike<Fixed128> for Fixed128

impl Eq for Fixed128

impl<P> From<P> for Fixed128 where
    P: PerThing, 

fn from(val: P) -> Fixed128

Performs the conversion.

impl Ord for Fixed128

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

This method returns an [Ordering] between self and other.

#[must_use]fn max(self, other: Self) -> Self

Compares and returns the maximum of two values.

#[must_use]fn min(self, other: Self) -> Self

Compares and returns the minimum of two values.

#[must_use]fn clamp(self, min: Self, max: Self) -> Self

🔬 This is a nightly-only experimental API. (clamp)

Restrict a value to a certain interval.

impl PartialEq<Fixed128> for Fixed128

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

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

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

This method tests for !=.

impl PartialOrd<Fixed128> for Fixed128

fn partial_cmp(&self, other: &Fixed128) -> Option<Ordering>

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

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

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

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

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

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

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

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

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

impl Saturating for Fixed128

fn saturating_add(self, rhs: Fixed128) -> Fixed128

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

fn saturating_sub(self, rhs: Fixed128) -> Fixed128

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

fn saturating_mul(self, rhs: Fixed128) -> Fixed128

Saturating multiply. Compute self * rhs, saturating at the numeric bounds instead of overflowing.

fn saturating_pow(self, exp: usize) -> Fixed128

Saturating exponentiation. Compute self.pow(exp), saturating at the numeric bounds instead of overflowing.

impl Serialize for Fixed128

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

Serialize this value into the given Serde serializer.

impl StructuralEq for Fixed128

impl StructuralPartialEq for Fixed128

impl Sub<Fixed128> for Fixed128

Note that this is a standard, potentially-panicking, implementation. Use Saturating trait for safe subtraction.

type Output = Fixed128

The resulting type after applying the - operator.

fn sub(self, rhs: Fixed128) -> <Fixed128 as Sub<Fixed128>>::Output

Performs the - operation.