Struct polkadot_sdk_frame::arithmetic::fixed_point::FixedU64

pub struct FixedU64(/* private fields */);

A fixed point number representation in the range. Fixed Point 64 bits unsigned, range = [0.000000000, 18446744073.709551615]

Implementations

impl FixedU64

pub const fn from_inner(inner: u64) -> FixedU64

Create a new instance from the given inner value.

const version of FixedPointNumber::from_inner.

pub const fn into_inner(self) -> u64

Return the instance’s inner value.

const version of FixedPointNumber::into_inner.

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

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) -> FixedU64

Convert from a float value.

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

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>(self) -> Result<P, P>

where P: PerThing,

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>(self) -> P

where P: PerThing,

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) -> FixedU64

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) -> FixedU64

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<FixedU64>

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

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

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: FixedU64) -> FixedU64

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: FixedU64) -> FixedU64

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: FixedU64) -> FixedU64

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) -> FixedU64

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, ) -> FixedU64

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: FixedU64) -> Option<FixedU64>

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: FixedU64, rounding: SignedRounding, ) -> Option<FixedU64>

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: FixedU64) -> Option<FixedU64>

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: FixedU64, rounding: SignedRounding, ) -> Option<FixedU64>

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 for FixedU64

type Output = FixedU64

The resulting type after applying the + operator.

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

Performs the + operation.

impl Bounded for FixedU64

fn min_value() -> FixedU64

Returns the smallest finite number this type can represent

fn max_value() -> FixedU64

Returns the largest finite number this type can represent

impl CheckedAdd for FixedU64

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

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

impl CheckedDiv for FixedU64

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

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

impl CheckedMul for FixedU64

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

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

impl CheckedSub for FixedU64

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

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

impl Clone for FixedU64

fn clone(&self) -> FixedU64

Returns a copy of the value.

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

Performs copy-assignment from source.

impl CompactAs for FixedU64

type As = u64

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

fn encode_as(&self) -> &u64

Returns the compact-encodable type.

fn decode_from(x: u64) -> Result<FixedU64, Error>

Decode Self from the compact-decoded type.

impl Debug for FixedU64

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

Formats the value using the given formatter.

impl Decode for FixedU64

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

where __CodecInputEdqy: Input,

Attempt to deserialise the value from input.

fn decode_into<I>( input: &mut I, dst: &mut MaybeUninit<Self>, ) -> Result<DecodeFinished, Error>

where I: Input,

Attempt to deserialize the value from input into a pre-allocated piece of memory.

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 FixedU64

fn default() -> FixedU64

Returns the “default value” for a type.

impl<'de> Deserialize<'de> for FixedU64

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

where D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Display for FixedU64

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

Formats the value using the given formatter.

impl Div for FixedU64

type Output = FixedU64

The resulting type after applying the / operator.

fn div(self, rhs: FixedU64) -> <FixedU64 as Div>::Output

Performs the / operation.

impl Encode for FixedU64

fn size_hint(&self) -> usize

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

fn encode_to<__CodecOutputEdqy>( &self, __codec_dest_edqy: &mut __CodecOutputEdqy, )

where __CodecOutputEdqy: Output + ?Sized,

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<__CodecOutputReturn, __CodecUsingEncodedCallback>( &self, f: __CodecUsingEncodedCallback, ) -> __CodecOutputReturn

where __CodecUsingEncodedCallback: FnOnce(&[u8]) -> __CodecOutputReturn,

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

fn encoded_size(&self) -> usize

Calculates the encoded size.

impl FixedPointNumber for FixedU64

type Inner = u64

The underlying data type used for this fixed point number.

const DIV: <FixedU64 as FixedPointNumber>::Inner = {transmute(0x000000003b9aca00): <sp_runtime::FixedU64 as sp_runtime::FixedPointNumber>::Inner}

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

const SIGNED: bool = false

Indicates if this fixed point implementation is signed or not.

fn from_inner(inner: <FixedU64 as FixedPointNumber>::Inner) -> FixedU64

Builds this type from an integer number.

fn into_inner(self) -> <FixedU64 as FixedPointNumber>::Inner

Consumes self and returns the inner raw value.

fn accuracy() -> Self::Inner

Precision of this fixed point implementation.

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

where N: FixedPointOperand,

Creates self from an integer number int.

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

where N: Into<Self::Inner>,

Creates self from an integer number int.

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

where N: FixedPointOperand, D: FixedPointOperand,

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

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

where N: FixedPointOperand, D: FixedPointOperand,

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

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

where N: FixedPointOperand,

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

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

where N: FixedPointOperand,

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

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

where N: FixedPointOperand,

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

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

where N: FixedPointOperand,

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

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

where N: FixedPointOperand,

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, D> From<(N, D)> for FixedU64

where N: FixedPointOperand, D: FixedPointOperand,

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

Converts to this type from the input type.

impl From<Compact<FixedU64>> for FixedU64

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

Converts to this type from the input type.

impl<P> From<P> for FixedU64

where P: PerThing, <P as PerThing>::Inner: FixedPointOperand,

fn from(p: P) -> FixedU64

Converts to this type from the input type.

impl From<u64> for FixedU64

fn from(int: u64) -> FixedU64

Converts to this type from the input type.

impl FromStr for FixedU64

type Err = &'static str

The associated error which can be returned from parsing.

fn from_str(s: &str) -> Result<FixedU64, <FixedU64 as FromStr>::Err>

Parses a string s to return a value of this type.

impl MaxEncodedLen for FixedU64

fn max_encoded_len() -> usize

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

impl Mul for FixedU64

type Output = FixedU64

The resulting type after applying the * operator.

fn mul(self, rhs: FixedU64) -> <FixedU64 as Mul>::Output

Performs the * operation.

impl Neg for FixedU64

type Output = FixedU64

The resulting type after applying the - operator.

fn neg(self) -> <FixedU64 as Neg>::Output

Performs the unary - operation.

impl One for FixedU64

fn one() -> FixedU64

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) -> bool

where Self: PartialEq,

Returns true if self is equal to the multiplicative identity.

impl Ord for FixedU64

fn cmp(&self, other: &FixedU64) -> 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 PartialEq for FixedU64

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

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

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

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

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

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

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

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

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

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

fn saturating_less_one(self) -> Self

where Self: One,

Decrement self by one, saturating at zero.

fn saturating_plus_one(self) -> Self

where Self: One,

Increment self by one, 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 FixedU64

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 Sub for FixedU64

type Output = FixedU64

The resulting type after applying the - operator.

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

Performs the - operation.

impl TypeInfo for FixedU64

type Identity = FixedU64

The type identifying for which type info is provided.

fn type_info() -> Type

Returns the static type identifier for Self.

impl Zero for FixedU64

fn zero() -> FixedU64

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 FixedU64

impl EncodeLike for FixedU64

impl Eq for FixedU64

impl StructuralPartialEq for FixedU64