Struct cosmwasm_std::Uint64

source ·
pub struct Uint64(/* private fields */);
Expand description

A thin wrapper around u64 that is using strings for JSON encoding/decoding, such that the full u64 range can be used for clients that convert JSON numbers to floats, like JavaScript and jq.

§Examples

Use from to create instances of this and u64 to get the value out:

let a = Uint64::from(42u64);
assert_eq!(a.u64(), 42);

let b = Uint64::from(70u32);
assert_eq!(b.u64(), 70);

Implementations§

source§

impl Uint64

source

pub const MAX: Self = _

source

pub const MIN: Self = _

source

pub const fn new(value: u64) -> Self

Creates a Uint64(value).

This method is less flexible than from but can be called in a const context.

source

pub const fn zero() -> Self

Creates a Uint64(0)

source

pub const fn one() -> Self

Creates a Uint64(1)

source

pub const fn u64(&self) -> u64

Returns a copy of the internal data

source

pub const fn to_be_bytes(self) -> [u8; 8]

Returns a copy of the number as big endian bytes.

source

pub const fn to_le_bytes(self) -> [u8; 8]

Returns a copy of the number as little endian bytes.

source

pub const fn is_zero(&self) -> bool

source

pub fn pow(self, exp: u32) -> Self

source

pub fn multiply_ratio<A: Into<u64>, B: Into<u64>>( &self, numerator: A, denominator: B ) -> Uint64

Returns self * numerator / denominator.

Due to the nature of the integer division involved, the result is always floored. E.g. 5 * 99/100 = 4.

source

pub fn checked_multiply_ratio<A: Into<u64>, B: Into<u64>>( &self, numerator: A, denominator: B ) -> Result<Uint64, CheckedMultiplyRatioError>

Returns self * numerator / denominator.

Due to the nature of the integer division involved, the result is always floored. E.g. 5 * 99/100 = 4.

source

pub fn full_mul(self, rhs: impl Into<u64>) -> Uint128

Multiplies two Uint64/u64 values without overflow, producing an Uint128.

§Examples
use cosmwasm_std::Uint64;

let a = Uint64::MAX;
let result = a.full_mul(2u32);
assert_eq!(result.to_string(), "36893488147419103230");
source

pub fn checked_add(self, other: Self) -> Result<Self, OverflowError>

source

pub fn checked_sub(self, other: Self) -> Result<Self, OverflowError>

source

pub fn checked_mul(self, other: Self) -> Result<Self, OverflowError>

source

pub fn checked_pow(self, exp: u32) -> Result<Self, OverflowError>

source

pub fn checked_div(self, other: Self) -> Result<Self, DivideByZeroError>

source

pub fn checked_div_euclid(self, other: Self) -> Result<Self, DivideByZeroError>

source

pub fn checked_rem(self, other: Self) -> Result<Self, DivideByZeroError>

source

pub fn checked_shr(self, other: u32) -> Result<Self, OverflowError>

source

pub fn checked_shl(self, other: u32) -> Result<Self, OverflowError>

source

pub fn wrapping_add(self, other: Self) -> Self

source

pub fn wrapping_sub(self, other: Self) -> Self

source

pub fn wrapping_mul(self, other: Self) -> Self

source

pub fn wrapping_pow(self, other: u32) -> Self

source

pub fn saturating_add(self, other: Self) -> Self

source

pub fn saturating_sub(self, other: Self) -> Self

source

pub fn saturating_mul(self, other: Self) -> Self

source

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

source

pub const fn abs_diff(self, other: Self) -> Self

source§

impl Uint64

source

pub fn checked_mul_floor<F: Fraction<T>, T: Into<Uint64>>( self, rhs: F ) -> Result<Self, CheckedMultiplyFractionError>

Multiply self with a struct implementing Fraction (e.g. crate::Decimal). Result is rounded down.

§Examples
use cosmwasm_std::Uint128;
let fraction = (8u128, 21u128);
let res = Uint128::new(123456).checked_mul_floor(fraction).unwrap();
assert_eq!(Uint128::new(47030), res); // 47030.8571 rounds down
source

pub fn mul_floor<F: Fraction<T>, T: Into<Uint64>>(self, rhs: F) -> Self

Same operation as checked_mul_floor except unwrapped

source

pub fn checked_mul_ceil<F: Fraction<T>, T: Into<Uint64>>( self, rhs: F ) -> Result<Self, CheckedMultiplyFractionError>

Multiply self with a struct implementing Fraction (e.g. crate::Decimal). Result is rounded up.

§Examples
use cosmwasm_std::Uint128;
let fraction = (8u128, 21u128);
let res = Uint128::new(123456).checked_mul_ceil(fraction).unwrap();
assert_eq!(Uint128::new(47031), res); // 47030.8571 rounds up
source

pub fn mul_ceil<F: Fraction<T>, T: Into<Uint64>>(self, rhs: F) -> Self

Same operation as checked_mul_ceil except unwrapped

source

pub fn checked_div_floor<F: Fraction<T>, T: Into<Uint64>>( self, rhs: F ) -> Result<Self, CheckedMultiplyFractionError>
where Self: Sized,

Divide self with a struct implementing Fraction (e.g. crate::Decimal). Result is rounded down.

§Examples
use cosmwasm_std::Uint128;
let fraction = (4u128, 5u128);
let res = Uint128::new(789).checked_div_floor(fraction).unwrap();
assert_eq!(Uint128::new(986), res); // 986.25 rounds down
source

pub fn div_floor<F: Fraction<T>, T: Into<Uint64>>(self, rhs: F) -> Self
where Self: Sized,

Same operation as checked_div_floor except unwrapped

source

pub fn checked_div_ceil<F: Fraction<T>, T: Into<Uint64>>( self, rhs: F ) -> Result<Self, CheckedMultiplyFractionError>
where Self: Sized,

Divide self with a struct implementing Fraction (e.g. crate::Decimal). Result is rounded up.

§Examples
use cosmwasm_std::Uint128;
let fraction = (4u128, 5u128);
let res = Uint128::new(789).checked_div_ceil(fraction).unwrap();
assert_eq!(Uint128::new(987), res); // 986.25 rounds up
source

pub fn div_ceil<F: Fraction<T>, T: Into<Uint64>>(self, rhs: F) -> Self
where Self: Sized,

Same operation as checked_div_ceil except unwrapped

Trait Implementations§

source§

impl<'a> Add<&'a Uint64> for Uint64

§

type Output = Uint64

The resulting type after applying the + operator.
source§

fn add(self, rhs: &'a Uint64) -> Self

Performs the + operation. Read more
source§

impl Add for Uint64

§

type Output = Uint64

The resulting type after applying the + operator.
source§

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

Performs the + operation. Read more
source§

impl<'a> AddAssign<&'a Uint64> for Uint64

source§

fn add_assign(&mut self, rhs: &'a Uint64)

Performs the += operation. Read more
source§

impl AddAssign for Uint64

source§

fn add_assign(&mut self, rhs: Uint64)

Performs the += operation. Read more
source§

impl Clone for Uint64

source§

fn clone(&self) -> Uint64

Returns a copy of the value. Read more
1.0.0 · source§

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

Performs copy-assignment from source. Read more
source§

impl Debug for Uint64

source§

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

Formats the value using the given formatter. Read more
source§

impl Default for Uint64

source§

fn default() -> Uint64

Returns the “default value” for a type. Read more
source§

impl<'de> Deserialize<'de> for Uint64

source§

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

Deserialized from an integer string using base 10

source§

impl Display for Uint64

source§

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

Formats the value using the given formatter. Read more
source§

impl<'a> Div<&'a Uint64> for Uint64

§

type Output = Uint64

The resulting type after applying the / operator.
source§

fn div(self, rhs: &'a Uint64) -> Self::Output

Performs the / operation. Read more
source§

impl Div for Uint64

§

type Output = Uint64

The resulting type after applying the / operator.
source§

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

Performs the / operation. Read more
source§

impl<'a> DivAssign<&'a Uint64> for Uint64

source§

fn div_assign(&mut self, rhs: &'a Uint64)

Performs the /= operation. Read more
source§

impl DivAssign for Uint64

source§

fn div_assign(&mut self, rhs: Self)

Performs the /= operation. Read more
source§

impl From<Uint64> for Int128

source§

fn from(val: Uint64) -> Self

Converts to this type from the input type.
source§

impl From<Uint64> for Int256

source§

fn from(val: Uint64) -> Self

Converts to this type from the input type.
source§

impl From<Uint64> for Int512

source§

fn from(val: Uint64) -> Self

Converts to this type from the input type.
source§

impl From<Uint64> for String

source§

fn from(original: Uint64) -> Self

Converts to this type from the input type.
source§

impl From<Uint64> for Uint128

source§

fn from(val: Uint64) -> Self

Converts to this type from the input type.
source§

impl From<Uint64> for Uint256

source§

fn from(val: Uint64) -> Self

Converts to this type from the input type.
source§

impl From<Uint64> for Uint512

source§

fn from(val: Uint64) -> Self

Converts to this type from the input type.
source§

impl From<Uint64> for u64

source§

fn from(original: Uint64) -> Self

Converts to this type from the input type.
source§

impl From<u16> for Uint64

source§

fn from(val: u16) -> Self

Converts to this type from the input type.
source§

impl From<u32> for Uint64

source§

fn from(val: u32) -> Self

Converts to this type from the input type.
source§

impl From<u64> for Uint64

source§

fn from(val: u64) -> Self

Converts to this type from the input type.
source§

impl From<u8> for Uint64

source§

fn from(val: u8) -> Self

Converts to this type from the input type.
source§

impl JsonSchema for Uint64

source§

fn schema_name() -> String

The name of the generated JSON Schema. Read more
source§

fn schema_id() -> Cow<'static, str>

Returns a string that uniquely identifies the schema produced by this type. Read more
source§

fn json_schema(gen: &mut SchemaGenerator) -> Schema

Generates a JSON Schema for this type. Read more
source§

fn is_referenceable() -> bool

Whether JSON Schemas generated for this type should be re-used where possible using the $ref keyword. Read more
source§

impl Mul<&Uint64> for &Uint64

§

type Output = <Uint64 as Mul>::Output

The resulting type after applying the * operator.
source§

fn mul(self, other: &Uint64) -> <Uint64 as Mul<Uint64>>::Output

Performs the * operation. Read more
source§

impl Mul<&Uint64> for Uint64

§

type Output = <Uint64 as Mul>::Output

The resulting type after applying the * operator.
source§

fn mul(self, other: &Uint64) -> <Uint64 as Mul<Uint64>>::Output

Performs the * operation. Read more
source§

impl<'a> Mul<Uint64> for &'a Uint64

§

type Output = <Uint64 as Mul>::Output

The resulting type after applying the * operator.
source§

fn mul(self, other: Uint64) -> <Uint64 as Mul<Uint64>>::Output

Performs the * operation. Read more
source§

impl Mul for Uint64

§

type Output = Uint64

The resulting type after applying the * operator.
source§

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

Performs the * operation. Read more
source§

impl MulAssign<&Uint64> for Uint64

source§

fn mul_assign(&mut self, other: &Uint64)

Performs the *= operation. Read more
source§

impl MulAssign for Uint64

source§

fn mul_assign(&mut self, rhs: Self)

Performs the *= operation. Read more
source§

impl Not for Uint64

§

type Output = Uint64

The resulting type after applying the ! operator.
source§

fn not(self) -> Self::Output

Performs the unary ! operation. Read more
source§

impl Ord for Uint64

source§

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

This method returns an Ordering between self and other. Read more
1.21.0 · source§

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

Compares and returns the maximum of two values. Read more
1.21.0 · source§

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

Compares and returns the minimum of two values. Read more
1.50.0 · source§

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

Restrict a value to a certain interval. Read more
source§

impl PartialEq<&Uint64> for Uint64

source§

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

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

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.
source§

impl<'a> PartialEq<Uint64> for &'a Uint64

source§

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

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

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.
source§

impl PartialEq for Uint64

source§

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

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

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.
source§

impl PartialOrd for Uint64

source§

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

This method returns an ordering between self and other values if one exists. Read more
1.0.0 · source§

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

This method tests less than (for self and other) and is used by the < operator. Read more
1.0.0 · source§

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

This method tests less than or equal to (for self and other) and is used by the <= operator. Read more
1.0.0 · source§

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

This method tests greater than (for self and other) and is used by the > operator. Read more
1.0.0 · source§

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

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

impl Rem<&Uint64> for &Uint64

§

type Output = <Uint64 as Rem>::Output

The resulting type after applying the % operator.
source§

fn rem(self, other: &Uint64) -> <Uint64 as Rem<Uint64>>::Output

Performs the % operation. Read more
source§

impl Rem<&Uint64> for Uint64

§

type Output = <Uint64 as Rem>::Output

The resulting type after applying the % operator.
source§

fn rem(self, other: &Uint64) -> <Uint64 as Rem<Uint64>>::Output

Performs the % operation. Read more
source§

impl<'a> Rem<Uint64> for &'a Uint64

§

type Output = <Uint64 as Rem>::Output

The resulting type after applying the % operator.
source§

fn rem(self, other: Uint64) -> <Uint64 as Rem<Uint64>>::Output

Performs the % operation. Read more
source§

impl Rem for Uint64

source§

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

§Panics

This operation will panic if rhs is zero.

§

type Output = Uint64

The resulting type after applying the % operator.
source§

impl RemAssign<&Uint64> for Uint64

source§

fn rem_assign(&mut self, other: &Uint64)

Performs the %= operation. Read more
source§

impl RemAssign for Uint64

source§

fn rem_assign(&mut self, rhs: Uint64)

Performs the %= operation. Read more
source§

impl Serialize for Uint64

source§

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

Serializes as an integer string using base 10

source§

impl<'a> Shl<&'a u32> for Uint64

§

type Output = Uint64

The resulting type after applying the << operator.
source§

fn shl(self, rhs: &'a u32) -> Self::Output

Performs the << operation. Read more
source§

impl Shl<u32> for Uint64

§

type Output = Uint64

The resulting type after applying the << operator.
source§

fn shl(self, rhs: u32) -> Self::Output

Performs the << operation. Read more
source§

impl<'a> ShlAssign<&'a u32> for Uint64

source§

fn shl_assign(&mut self, rhs: &'a u32)

Performs the <<= operation. Read more
source§

impl ShlAssign<u32> for Uint64

source§

fn shl_assign(&mut self, rhs: u32)

Performs the <<= operation. Read more
source§

impl<'a> Shr<&'a u32> for Uint64

§

type Output = Uint64

The resulting type after applying the >> operator.
source§

fn shr(self, rhs: &'a u32) -> Self::Output

Performs the >> operation. Read more
source§

impl Shr<u32> for Uint64

§

type Output = Uint64

The resulting type after applying the >> operator.
source§

fn shr(self, rhs: u32) -> Self::Output

Performs the >> operation. Read more
source§

impl<'a> ShrAssign<&'a u32> for Uint64

source§

fn shr_assign(&mut self, rhs: &'a u32)

Performs the >>= operation. Read more
source§

impl ShrAssign<u32> for Uint64

source§

fn shr_assign(&mut self, rhs: u32)

Performs the >>= operation. Read more
source§

impl Sub<&Uint64> for &Uint64

§

type Output = <Uint64 as Sub>::Output

The resulting type after applying the - operator.
source§

fn sub(self, other: &Uint64) -> <Uint64 as Sub<Uint64>>::Output

Performs the - operation. Read more
source§

impl Sub<&Uint64> for Uint64

§

type Output = <Uint64 as Sub>::Output

The resulting type after applying the - operator.
source§

fn sub(self, other: &Uint64) -> <Uint64 as Sub<Uint64>>::Output

Performs the - operation. Read more
source§

impl<'a> Sub<Uint64> for &'a Uint64

§

type Output = <Uint64 as Sub>::Output

The resulting type after applying the - operator.
source§

fn sub(self, other: Uint64) -> <Uint64 as Sub<Uint64>>::Output

Performs the - operation. Read more
source§

impl Sub for Uint64

§

type Output = Uint64

The resulting type after applying the - operator.
source§

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

Performs the - operation. Read more
source§

impl SubAssign<&Uint64> for Uint64

source§

fn sub_assign(&mut self, other: &Uint64)

Performs the -= operation. Read more
source§

impl SubAssign for Uint64

source§

fn sub_assign(&mut self, rhs: Uint64)

Performs the -= operation. Read more
source§

impl<A> Sum<A> for Uint64
where Self: Add<A, Output = Self>,

source§

fn sum<I: Iterator<Item = A>>(iter: I) -> Self

Method which takes an iterator and generates Self from the elements by “summing up” the items.
source§

impl TryFrom<&str> for Uint64

§

type Error = StdError

The type returned in the event of a conversion error.
source§

fn try_from(val: &str) -> Result<Self, Self::Error>

Performs the conversion.
source§

impl TryFrom<Int128> for Uint64

§

type Error = ConversionOverflowError

The type returned in the event of a conversion error.
source§

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

Performs the conversion.
source§

impl TryFrom<Int256> for Uint64

§

type Error = ConversionOverflowError

The type returned in the event of a conversion error.
source§

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

Performs the conversion.
source§

impl TryFrom<Int512> for Uint64

§

type Error = ConversionOverflowError

The type returned in the event of a conversion error.
source§

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

Performs the conversion.
source§

impl TryFrom<Int64> for Uint64

§

type Error = ConversionOverflowError

The type returned in the event of a conversion error.
source§

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

Performs the conversion.
source§

impl TryFrom<Uint128> for Uint64

§

type Error = ConversionOverflowError

The type returned in the event of a conversion error.
source§

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

Performs the conversion.
source§

impl TryFrom<Uint256> for Uint64

§

type Error = ConversionOverflowError

The type returned in the event of a conversion error.
source§

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

Performs the conversion.
source§

impl TryFrom<Uint512> for Uint64

§

type Error = ConversionOverflowError

The type returned in the event of a conversion error.
source§

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

Performs the conversion.
source§

impl TryFrom<Uint64> for Int64

§

type Error = ConversionOverflowError

The type returned in the event of a conversion error.
source§

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

Performs the conversion.
source§

impl Copy for Uint64

source§

impl Eq for Uint64

source§

impl StructuralPartialEq for Uint64

Auto Trait Implementations§

Blanket Implementations§

source§

impl<T> Any for T
where T: 'static + ?Sized,

source§

fn type_id(&self) -> TypeId

Gets the TypeId of self. Read more
source§

impl<U> As for U

source§

fn as_<T>(self) -> T
where T: CastFrom<U>,

Casts self to type T. The semantics of numeric casting with the as operator are followed, so <T as As>::as_::<U> can be used in the same way as T as U for numeric conversions. Read more
source§

impl<T> Borrow<T> for T
where T: ?Sized,

source§

fn borrow(&self) -> &T

Immutably borrows from an owned value. Read more
source§

impl<T> BorrowMut<T> for T
where T: ?Sized,

source§

fn borrow_mut(&mut self) -> &mut T

Mutably borrows from an owned value. Read more
source§

impl<T> DynClone for T
where T: Clone,

source§

fn __clone_box(&self, _: Private) -> *mut ()

source§

impl<T> From<T> for T

source§

fn from(t: T) -> T

Returns the argument unchanged.

source§

impl<T, U> Into<U> for T
where U: From<T>,

source§

fn into(self) -> U

Calls U::from(self).

That is, this conversion is whatever the implementation of From<T> for U chooses to do.

source§

impl<I> Isqrt for I
where I: Div<Output = I> + Unsigned + Shr<u32, Output = I> + Add<Output = I> + PartialOrd + Copy + From<u8>,

source§

fn isqrt(self) -> I

Algorithm adapted from Wikipedia.

source§

impl<T> Same for T

§

type Output = T

Should always be Self
source§

impl<T> ToOwned for T
where T: Clone,

§

type Owned = T

The resulting type after obtaining ownership.
source§

fn to_owned(&self) -> T

Creates owned data from borrowed data, usually by cloning. Read more
source§

fn clone_into(&self, target: &mut T)

Uses borrowed data to replace owned data, usually by cloning. Read more
source§

impl<T> ToString for T
where T: Display + ?Sized,

source§

default fn to_string(&self) -> String

Converts the given value to a String. Read more
source§

impl<T, U> TryFrom<U> for T
where U: Into<T>,

§

type Error = Infallible

The type returned in the event of a conversion error.
source§

fn try_from(value: U) -> Result<T, <T as TryFrom<U>>::Error>

Performs the conversion.
source§

impl<T, U> TryInto<U> for T
where U: TryFrom<T>,

§

type Error = <U as TryFrom<T>>::Error

The type returned in the event of a conversion error.
source§

fn try_into(self) -> Result<U, <U as TryFrom<T>>::Error>

Performs the conversion.
source§

impl<T> DeserializeOwned for T
where T: for<'de> Deserialize<'de>,

§

impl<T, Rhs, Output> GroupOps<Rhs, Output> for T
where T: Add<Rhs, Output = Output> + Sub<Rhs, Output = Output> + AddAssign<Rhs> + SubAssign<Rhs>,

§

impl<T, Rhs, Output> GroupOpsOwned<Rhs, Output> for T
where T: for<'r> GroupOps<&'r Rhs, Output>,

§

impl<T, Rhs, Output> ScalarMul<Rhs, Output> for T
where T: Mul<Rhs, Output = Output> + MulAssign<Rhs>,

§

impl<T, Rhs, Output> ScalarMulOwned<Rhs, Output> for T
where T: for<'r> ScalarMul<&'r Rhs, Output>,