Struct Perbill

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

A fixed point representation of a number in the range [0, 1].

Parts per Billion

Implementations

impl Perbill

pub const fn from_parts(parts: u32) -> Perbill

From an explicitly defined number of parts per maximum of the type.

pub const fn from_percent(x: u32) -> Perbill

Converts a percent into Self. Equal to x / 100.

This can be created at compile time.

pub const fn one() -> Perbill

See [PerThing::one]

pub fn is_one(&self) -> bool

See [PerThing::is_one].

pub const fn zero() -> Perbill

See [PerThing::zero].

pub fn is_zero(&self) -> bool

See [PerThing::is_zero].

pub const fn deconstruct(self) -> u32

See [PerThing::deconstruct].

pub fn square(self) -> Perbill

See [PerThing::square].

pub fn from_float(x: f64) -> Perbill

See [PerThing::from_float].

pub fn from_rational_approximation<N>(p: N, q: N) -> Perbill

where N: RationalArg + TryInto<u32> + TryInto<u64>, u32: Into<N>,

👎Deprecated: Use PerThing::from_rational instead

See [PerThing::from_rational].

pub fn from_rational<N>(p: N, q: N) -> Perbill

where N: RationalArg + TryInto<u32> + TryInto<u64>, u32: Into<N>,

See [PerThing::from_rational].

pub fn int_mul(self, b: u32) -> Perbill

Integer multiplication with another value, saturating at 1.

pub fn int_div(self, b: Perbill) -> u32

Integer division with another value, rounding down.

pub fn mul_floor<N>(self, b: N) -> N

where N: MultiplyArg + UniqueSaturatedInto<u32>, u32: Into<N>,

See [PerThing::mul_floor].

pub fn mul_ceil<N>(self, b: N) -> N

where N: MultiplyArg + UniqueSaturatedInto<u32>, u32: Into<N>,

See [PerThing::mul_ceil].

pub fn saturating_reciprocal_mul<N>(self, b: N) -> N

where N: ReciprocalArg + UniqueSaturatedInto<u32>, u32: Into<N>,

See [PerThing::saturating_reciprocal_mul].

pub fn saturating_reciprocal_mul_floor<N>(self, b: N) -> N

where N: ReciprocalArg + UniqueSaturatedInto<u32>, u32: Into<N>,

See [PerThing::saturating_reciprocal_mul_floor].

pub fn saturating_reciprocal_mul_ceil<N>(self, b: N) -> N

where N: ReciprocalArg + UniqueSaturatedInto<u32>, u32: Into<N>,

See [PerThing::saturating_reciprocal_mul_ceil].

pub fn saturating_div(self, rhs: Perbill, r: Rounding) -> Perbill

Saturating division. Compute self / rhs, saturating at one if rhs < self.

The rounding method must be specified. e.g.:

let pc = |x| Percent::from_percent(x);
assert_eq!(
	pc(2).saturating_div(pc(3), Down),
	pc(66),
);
assert_eq!(
	pc(1).saturating_div(pc(3), NearestPrefUp),
	pc(33),
);
assert_eq!(
	pc(2).saturating_div(pc(3), NearestPrefDown),
	pc(67),
);
assert_eq!(
	pc(1).saturating_div(pc(3), Up),
	pc(34),
);

impl Perbill

pub const fn from_perthousand(x: u32) -> Perbill

Converts a percent into Self. Equal to x / 1000.

This can be created at compile time.

Trait Implementations

impl Add for Perbill

type Output = Perbill

The resulting type after applying the + operator.

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

Performs the + operation.

impl Bounded for Perbill

fn min_value() -> Perbill

Returns the smallest finite number this type can represent

fn max_value() -> Perbill

Returns the largest finite number this type can represent

impl CheckedAdd for Perbill

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

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

impl CheckedMul for Perbill

Note

CheckedMul will never fail for PerThings.

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

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

impl CheckedSub for Perbill

fn checked_sub(&self, v: &Perbill) -> Option<Perbill>

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

impl Clone for Perbill

fn clone(&self) -> Perbill

Returns a copy of the value.

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

Performs copy-assignment from source.

impl CompactAs for Perbill

Implementation makes any compact encoding of PerThing::Inner valid, when decoding it will saturate up to PerThing::ACCURACY.

type As = u32

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

fn encode_as(&self) -> &<Perbill as CompactAs>::As

Returns the compact-encodable type.

fn decode_from(x: <Perbill as CompactAs>::As) -> Result<Perbill, Error>

Decode Self from the compact-decoded type.

impl Debug for Perbill

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

Formats the value using the given formatter.

impl Decode for Perbill

fn decode<I>(input: &mut I) -> Result<Perbill, Error>

where I: 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 Perbill

fn default() -> Perbill

Returns the “default value” for a type.

impl<'de> Deserialize<'de> for Perbill

fn deserialize<__D>( __deserializer: __D, ) -> Result<Perbill, <__D as Deserializer<'de>>::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl<N> Div<N> for Perbill

where u32: TryFrom<N>,

type Output = Perbill

The resulting type after applying the / operator.

fn div(self, b: N) -> <Perbill as Div<N>>::Output

Performs the / operation.

impl Div for Perbill

type Output = Perbill

The resulting type after applying the / operator.

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

Performs the / operation.

impl Encode for Perbill

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 From<Compact<Perbill>> for Perbill

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

Converts to this type from the input type.

impl MaxEncodedLen for Perbill

fn max_encoded_len() -> usize

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

impl<N> Mul<N> for Perbill

where N: Div<Output = N> + Clone + Mul<Output = N> + UniqueSaturatedInto<u32> + Add<Output = N> + Rem<Output = N> + Unsigned, u32: Into<N>,

Non-overflow multiplication.

This is tailored to be used with a balance type.

type Output = N

The resulting type after applying the * operator.

fn mul(self, b: N) -> <Perbill as Mul<N>>::Output

Performs the * operation.

impl Mul<Weight> for Perbill

type Output = Weight

The resulting type after applying the * operator.

fn mul(self, b: Weight) -> Weight

Performs the * operation.

impl Mul for Perbill

type Output = Perbill

The resulting type after applying the * operator.

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

Performs the * operation.

impl One for Perbill

fn one() -> Perbill

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 Perbill

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

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

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

fn deconstruct(self) -> <Perbill as PerThing>::Inner

Consume self and return the number of parts per thing.

fn from_parts(parts: <Perbill as PerThing>::Inner) -> Perbill

Build this type from a number of parts per thing.

fn from_float(x: f64) -> Perbill

NOTE: saturate to 0 or 1 if x is beyond [0, 1]

const ACCURACY: <Perbill as PerThing>::Inner = {transmute(0x3b9aca00): <sp_runtime::Perbill as sp_runtime::PerThing>::Inner}

The accuracy of this type.

type Inner = u32

The data type used to build this per-thingy.

type Upper = u64

A data type larger than Self::Inner, used to avoid overflow in some computations. It must be able to compute ACCURACY^2.

fn from_rational_with_rounding<N>( p: N, q: N, r: Rounding, ) -> Result<Perbill, ()>

where N: Clone + Ord + TryInto<<Perbill as PerThing>::Inner> + TryInto<<Perbill as PerThing>::Upper> + Div<Output = N> + Rem<Output = N> + Add<Output = N> + AddAssign + Unsigned + Zero + One + MultiplyRational, <Perbill as PerThing>::Inner: Into<N>,

Approximate the fraction p/q into a per-thing fraction.

fn zero() -> Self

Equivalent to Self::from_parts(0).

fn is_zero(&self) -> bool

Return true if this is nothing.

fn one() -> Self

Equivalent to Self::from_parts(Self::ACCURACY).

fn is_one(&self) -> bool

Return true if this is one.

fn less_epsilon(self) -> Self

Return the next lower value to self or self if it is already zero.

fn try_less_epsilon(self) -> Result<Self, Self>

Return the next lower value to self or an error with the same value if self is already zero.

fn plus_epsilon(self) -> Self

Return the next higher value to self or self if it is already one.

fn try_plus_epsilon(self) -> Result<Self, Self>

Return the next higher value to self or an error with the same value if self is already one.

fn from_percent(x: Self::Inner) -> Self

Build this type from a percent. Equivalent to Self::from_parts(x * Self::ACCURACY / 100) but more accurate and can cope with potential type overflows.

fn square(self) -> Self

Return the product of multiplication of this value by itself.

fn left_from_one(self) -> Self

Return the part left when self is saturating-subtracted from Self::one().

fn mul_floor<N>(self, b: N) -> N

where N: MultiplyArg + UniqueSaturatedInto<Self::Inner>, Self::Inner: Into<N>,

Multiplication that always rounds down to a whole number. The standard Mul rounds to the nearest whole number.

fn mul_ceil<N>(self, b: N) -> N

where N: MultiplyArg + UniqueSaturatedInto<Self::Inner>, Self::Inner: Into<N>,

Multiplication that always rounds the result up to a whole number. The standard Mul rounds to the nearest whole number.

fn saturating_reciprocal_mul<N>(self, b: N) -> N

where N: ReciprocalArg + UniqueSaturatedInto<Self::Inner>, Self::Inner: Into<N>,

Saturating multiplication by the reciprocal of self. The result is rounded to the nearest whole number and saturates at the numeric bounds instead of overflowing.

fn saturating_reciprocal_mul_floor<N>(self, b: N) -> N

where N: ReciprocalArg + UniqueSaturatedInto<Self::Inner>, Self::Inner: Into<N>,

Saturating multiplication by the reciprocal of self. The result is rounded down to the nearest whole number and saturates at the numeric bounds instead of overflowing.

fn saturating_reciprocal_mul_ceil<N>(self, b: N) -> N

where N: ReciprocalArg + UniqueSaturatedInto<Self::Inner>, Self::Inner: Into<N>,

Saturating multiplication by the reciprocal of self. The result is rounded up to the nearest whole number and saturates at the numeric bounds instead of overflowing.

fn from_fraction(x: f64) -> Self

👎Deprecated: Use from_float instead

Same as Self::from_float.

fn from_rational<N>(p: N, q: N) -> Self

where N: RationalArg + TryInto<Self::Inner> + TryInto<Self::Upper>, Self::Inner: Into<N>,

Approximate the fraction p/q into a per-thing fraction. This will never overflow.

fn from_rational_approximation<N>(p: N, q: N) -> Self

where N: RationalArg + TryInto<Self::Inner> + TryInto<Self::Upper>, Self::Inner: Into<N>,

👎Deprecated: Use from_rational instead

Same as Self::from_rational.

impl Pow<usize> for Perbill

type Output = Perbill

The result after applying the operator.

fn pow(self, exp: usize) -> <Perbill as Pow<usize>>::Output

Returns self to the power rhs.

impl Saturating for Perbill

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

Saturating addition. Compute self + rhs, saturating at the numeric bounds instead of overflowing. This operation is lossless if it does not saturate.

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

Saturating subtraction. Compute self - rhs, saturating at the numeric bounds instead of overflowing. This operation is lossless if it does not saturate.

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

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

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

Saturating exponentiation. Computes self.pow(exp), saturating at the numeric bounds instead of overflowing. This operation is lossy.

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 SaturatingAdd for Perbill

fn saturating_add(&self, v: &Perbill) -> Perbill

Saturating addition. Computes self + other, saturating at the relevant high or low boundary of the type.

impl SaturatingSub for Perbill

fn saturating_sub(&self, v: &Perbill) -> Perbill

Saturating subtraction. Computes self - other, saturating at the relevant high or low boundary of the type.

impl Serialize for Perbill

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 Perbill

type Output = Perbill

The resulting type after applying the - operator.

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

Performs the - operation.

impl TypeInfo for Perbill

type Identity = Perbill

The type identifying for which type info is provided.

fn type_info() -> Type

Returns the static type identifier for Self.

impl Zero for Perbill

fn zero() -> Perbill

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 Perbill

impl EncodeLike for Perbill

impl Eq for Perbill

impl StructuralPartialEq for Perbill