Struct sp_arithmetic::fixed_point::FixedI128

pub struct FixedI128(_);

A fixed point number representation in the range. Fixed Point 128 bits signed, range = [-170141183460469231731.687303715884105728, 170141183460469231731.687303715884105727]

Implementations

impl FixedI128

pub const fn from_inner(inner: i128) -> Self

Create a new instance from the given inner value.

const version of FixedPointNumber::from_inner.

pub const fn into_inner(self) -> i128

Return the instance’s inner value.

const version of FixedPointNumber::into_inner.

pub const fn from_u32(n: u32) -> Self

Creates self from a u32.

WARNING: This is a const function designed for convenient use at build time and will panic on overflow. Ensure that any inputs are sensible.

pub fn from_float(x: f64) -> Self

Convert from a float value.

pub const fn from_perbill(n: Perbill) -> Self

Convert from a Perbill value.

pub const fn into_perbill(self) -> Perbill

Convert into a Perbill value. Will saturate if above one or below zero.

pub fn to_float(self) -> f64

Convert into a float value.

pub fn try_into_perthing<P: PerThing>(self) -> Result<P, P>

Attempt to convert into a PerThing. This will succeed iff self is at least zero and at most one. If it is out of bounds, it will result in an error returning the clamped value.

pub fn into_clamped_perthing<P: PerThing>(self) -> P

Attempt to convert into a PerThing. This will always succeed resulting in a clamped value if self is less than zero or greater than one.

pub const fn neg(self) -> Self

Negate the value.

WARNING: This is a const function designed for convenient use at build time and will panic on overflow. Ensure that any inputs are sensible.

pub const fn sqrt(self) -> Self

Take the square root of a positive value.

WARNING: This is a const function designed for convenient use at build time and will panic on overflow. Ensure that any inputs are sensible.

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

Compute the square root, rounding as desired. If it overflows or is negative, then None is returned.

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

Add a value and return the result.

WARNING: This is a const function designed for convenient use at build time and will panic on overflow. Ensure that any inputs are sensible.

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

Subtract a value and return the result.

WARNING: This is a const function designed for convenient use at build time and will panic on overflow. Ensure that any inputs are sensible.

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

Multiply by a value and return the result.

Result will be rounded to the nearest representable value, rounding down if it is equidistant between two neighbours.

WARNING: This is a const function designed for convenient use at build time and will panic on overflow. Ensure that any inputs are sensible.

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

Divide by a value and return the result.

Result will be rounded to the nearest representable value, rounding down if it is equidistant between two neighbours.

WARNING: This is a const function designed for convenient use at build time and will panic on overflow. Ensure that any inputs are sensible.

pub const fn from_rational(a: u128, b: u128) -> Self

Calculate an approximation of a rational.

Result will be rounded to the nearest representable value, rounding down if it is equidistant between two neighbours.

WARNING: This is a const function designed for convenient use at build time and will panic on overflow. Ensure that any inputs are sensible.

pub const fn from_rational_with_rounding(
    a: u128,
    b: u128,
    rounding: Rounding
) -> Self

Calculate an approximation of a rational with custom rounding.

WARNING: This is a const function designed for convenient use at build time and will panic on overflow. Ensure that any inputs are sensible.

pub const fn const_checked_mul(self, other: Self) -> Option<Self>

Multiply by another value, returning None in the case of an error.

Result will be rounded to the nearest representable value, rounding down if it is equidistant between two neighbours.

pub const fn const_checked_mul_with_rounding(
    self,
    other: Self,
    rounding: SignedRounding
) -> Option<Self>

Multiply by another value with custom rounding, returning None in the case of an error.

Result will be rounded to the nearest representable value, rounding down if it is equidistant between two neighbours.

pub const fn const_checked_div(self, other: Self) -> Option<Self>

Divide by another value, returning None in the case of an error.

Result will be rounded to the nearest representable value, rounding down if it is equidistant between two neighbours.

pub const fn checked_rounding_div(
    self,
    other: Self,
    rounding: SignedRounding
) -> Option<Self>

Divide by another value with custom rounding, returning None in the case of an error.

Result will be rounded to the nearest representable value, rounding down if it is equidistant between two neighbours.

Trait Implementations

impl Add<FixedI128> for FixedI128

type Output = FixedI128

The resulting type after applying the + operator.

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

Performs the + operation.

impl Bounded for FixedI128

fn min_value() -> Self

Returns the smallest finite number this type can represent

fn max_value() -> Self

Returns the largest finite number this type can represent

impl CheckedAdd for FixedI128

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

Adds two numbers, checking for overflow. If overflow happens, None is returned.

impl CheckedDiv for FixedI128

fn checked_div(&self, other: &Self) -> Option<Self>

Divides two numbers, checking for underflow, overflow and division by zero. If any of that happens, None is returned.

impl CheckedMul for FixedI128

fn checked_mul(&self, other: &Self) -> Option<Self>

Multiplies two numbers, checking for underflow or overflow. If underflow or overflow happens, None is returned.

impl CheckedSub for FixedI128

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

Subtracts two numbers, checking for underflow. If underflow happens, None is returned.

impl Clone for FixedI128

fn clone(&self) -> FixedI128

Returns a copy of the value.

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

Performs copy-assignment from source.

impl CompactAs for FixedI128

type As = i128

A compact-encodable type that should be used as the encoding.

fn encode_as(&self) -> &i128

Returns the compact-encodable type.

fn decode_from(x: i128) -> Result<FixedI128, Error>

Decode Self from the compact-decoded type.

impl Debug for FixedI128

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

Formats the value using the given formatter.

impl Decode for FixedI128

fn decode<__CodecInputEdqy: Input>(
    __codec_input_edqy: &mut __CodecInputEdqy
) -> Result<Self, Error>

Attempt to deserialise the value from input.

fn skip<I>(input: &mut I) -> Result<(), Error>where
    I: Input,

Attempt to skip the encoded value from input.

fn encoded_fixed_size() -> Option<usize>

Returns the fixed encoded size of the type.

impl Default for FixedI128

fn default() -> FixedI128

Returns the “default value” for a type.

impl<'de> Deserialize<'de> for FixedI128

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

Deserialize this value from the given Serde deserializer.

impl Display for FixedI128

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

Formats the value using the given formatter.

impl Div<FixedI128> for FixedI128

type Output = FixedI128

The resulting type after applying the / operator.

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

Performs the / operation.

impl Encode for FixedI128

fn encode_to<__CodecOutputEdqy: Output + ?Sized>(
    &self,
    __codec_dest_edqy: &mut __CodecOutputEdqy
)

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: FnOnce(&[u8]) -> R>(&self, f: F) -> 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.

fn encoded_size(&self) -> usize

Calculates the encoded size.

impl FixedPointNumber for FixedI128

type Inner = i128

The underlying data type used for this fixed point number.

const DIV: Self::Inner = {transmute(0x00000000000000000de0b6b3a7640000): <fixed_point::FixedI128 as fixed_point::FixedPointNumber>::Inner}

Precision of this fixed point implementation. It should be a power of 10.

const SIGNED: bool = true

Indicates if this fixed point implementation is signed or not.

fn from_inner(inner: Self::Inner) -> Self

Builds this type from an integer number.

fn into_inner(self) -> Self::Inner

Consumes self and returns the inner raw value.

fn accuracy() -> Self::Inner

Precision of this fixed point implementation.

fn saturating_from_integer<N: FixedPointOperand>(int: N) -> Self

Creates self from an integer number int.

fn checked_from_integer<N: Into<Self::Inner>>(int: N) -> Option<Self>

Creates self from an integer number int.

fn saturating_from_rational<N: FixedPointOperand, D: FixedPointOperand>(
    n: N,
    d: D
) -> Self

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

fn checked_from_rational<N: FixedPointOperand, D: FixedPointOperand>(
    n: N,
    d: D
) -> Option<Self>

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

fn checked_mul_int<N: FixedPointOperand>(self, n: N) -> Option<N>

Checked multiplication for integer type N. Equal to self * n.

fn saturating_mul_int<N: FixedPointOperand>(self, n: N) -> N

Saturating multiplication for integer type N. Equal to self * n.

fn checked_div_int<N: FixedPointOperand>(self, d: N) -> Option<N>

Checked division for integer type N. Equal to self / d.

fn saturating_div_int<N: FixedPointOperand>(self, d: N) -> N

Saturating division for integer type N. Equal to self / d.

fn saturating_mul_acc_int<N: FixedPointOperand>(self, n: N) -> N

Saturating multiplication for integer type N, adding the result back. Equal to self * n + n.

fn saturating_abs(self) -> Self

Saturating absolute value.

fn reciprocal(self) -> Option<Self>

Takes the reciprocal (inverse). Equal to 1 / self.

fn is_one(&self) -> bool

Checks if the number is one.

fn is_positive(self) -> bool

Returns true if self is positive and false if the number is zero or negative.

fn is_negative(self) -> bool

Returns true if self is negative and false if the number is zero or positive.

fn trunc(self) -> Self

Returns the integer part.

fn frac(self) -> Self

Returns the fractional part.

fn ceil(self) -> Self

Returns the smallest integer greater than or equal to a number.

fn floor(self) -> Self

Returns the largest integer less than or equal to a number.

fn round(self) -> Self

Returns the number rounded to the nearest integer. Rounds half-way cases away from 0.0.

impl<N: FixedPointOperand, D: FixedPointOperand> From<(N, D)> for FixedI128

fn from(r: (N, D)) -> Self

Converts to this type from the input type.

impl From<Compact<FixedI128>> for FixedI128

fn from(x: Compact<FixedI128>) -> FixedI128

Converts to this type from the input type.

impl<P: PerThing> From<P> for FixedI128where
    P::Inner: FixedPointOperand,

fn from(p: P) -> Self

Converts to this type from the input type.

impl From<i128> for FixedI128

fn from(int: i128) -> Self

Converts to this type from the input type.

impl FromStr for FixedI128

type Err = &'static str

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 MaxEncodedLen for FixedI128

fn max_encoded_len() -> usize

Upper bound, in bytes, of the maximum encoded size of this item.

impl Mul<FixedI128> for FixedI128

type Output = FixedI128

The resulting type after applying the * operator.

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

Performs the * operation.

impl Neg for FixedI128

type Output = FixedI128

The resulting type after applying the - operator.

fn neg(self) -> Self::Output

Performs the unary - operation.

impl One for FixedI128

fn one() -> Self

Returns the multiplicative identity element of Self, 1.

fn set_one(&mut self)

Sets self to the multiplicative identity element of Self, 1.

fn is_one(&self) -> boolwhere
    Self: PartialEq<Self>,

Returns true if self is equal to the multiplicative identity.

impl Ord for FixedI128

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

This method returns an Ordering between self and other.

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

Compares and returns the maximum of two values.

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

Compares and returns the minimum of two values.

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

Restrict a value to a certain interval.

impl PartialEq<FixedI128> for FixedI128

fn eq(&self, other: &FixedI128) -> 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 PartialOrd<FixedI128> for FixedI128

fn partial_cmp(&self, other: &FixedI128) -> 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 Saturating for FixedI128

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

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

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

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

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

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

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

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

fn saturating_inc(&mut self)where
    Self: One,

Increment self by one, saturating.

fn saturating_dec(&mut self)where
    Self: One,

Decrement self by one, saturating at zero.

fn saturating_accrue(&mut self, amount: Self)where
    Self: One,

Increment self by some amount, saturating.

fn saturating_reduce(&mut self, amount: Self)where
    Self: One,

Decrement self by some amount, saturating at zero.

impl Serialize for FixedI128

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

Serialize this value into the given Serde serializer.

impl Sub<FixedI128> for FixedI128

type Output = FixedI128

The resulting type after applying the - operator.

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

Performs the - operation.

impl TypeInfo for FixedI128

type Identity = FixedI128

The type identifying for which type info is provided.

fn type_info() -> Type

Returns the static type identifier for Self.

impl Zero for FixedI128

fn zero() -> Self

Returns the additive identity element of Self, 0.

fn is_zero(&self) -> bool

Returns true if self is equal to the additive identity.

fn set_zero(&mut self)

Sets self to the additive identity element of Self, 0.

impl Copy for FixedI128

impl EncodeLike<FixedI128> for FixedI128

impl Eq for FixedI128

impl StructuralEq for FixedI128

impl StructuralPartialEq for FixedI128