Struct Int256

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

An implementation of i256 that is using strings for JSON encoding/decoding, such that the full i256 range can be used for clients that convert JSON numbers to floats, like JavaScript and jq.

Examples

Use from to create instances out of primitive uint types or new to provide big endian bytes:

let a = Int256::from(258u128);
let b = Int256::new([
    0u8, 0u8, 0u8, 0u8, 0u8, 0u8, 0u8, 0u8,
    0u8, 0u8, 0u8, 0u8, 0u8, 0u8, 0u8, 0u8,
    0u8, 0u8, 0u8, 0u8, 0u8, 0u8, 0u8, 0u8,
    0u8, 0u8, 0u8, 0u8, 0u8, 0u8, 1u8, 2u8,
]);
assert_eq!(a, b);

Implementations

impl Int256

pub const MAX: Int256

pub const MIN: Int256

pub const fn new(value: [u8; 32]) -> Self

Creates a Int256(value) from a big endian representation. It’s just an alias for from_be_bytes.

pub const fn zero() -> Self

Creates a Int256(0)

pub const fn one() -> Self

Creates a Int256(1)

pub const fn from_i128(v: i128) -> Self

A conversion from i128 that, unlike the one provided by the From trait, can be used in a const context.

pub const fn from_be_bytes(data: [u8; 32]) -> Self

pub const fn from_le_bytes(data: [u8; 32]) -> Self

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

Returns a copy of the number as big endian bytes.

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

Returns a copy of the number as little endian bytes.

pub const fn is_zero(&self) -> bool

pub const fn is_negative(&self) -> bool

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

pub fn checked_multiply_ratio<A: Into<Self>, B: Into<Self>>( &self, numerator: A, denominator: B, ) -> Result<Self, 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.

pub fn full_mul(self, rhs: impl Into<Self>) -> Int512

Multiplies two Int256 values without overflow, producing an Int512.

Examples

use cosmwasm_std::Int256;

let a = Int256::MAX;
let result = a.full_mul(2i32);
assert_eq!(
    result.to_string(),
    "115792089237316195423570985008687907853269984665640564039457584007913129639934"
);

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

pub const fn abs(self) -> Self

pub const fn unsigned_abs(self) -> Uint256

pub const fn strict_neg(self) -> Self

Strict negation. Computes -self, panicking if self == MIN.

This is the same as Int256::neg but const.

Trait Implementations

impl Add<&Int256> for &Int256

type Output = <Int256 as Add>::Output

The resulting type after applying the + operator.

fn add(self, other: &Int256) -> <Int256 as Add<Int256>>::Output

Performs the + operation.

impl Add<&Int256> for Int256

type Output = <Int256 as Add>::Output

The resulting type after applying the + operator.

fn add(self, other: &Int256) -> <Int256 as Add<Int256>>::Output

Performs the + operation.

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

type Output = <Int256 as Add>::Output

The resulting type after applying the + operator.

fn add(self, other: Int256) -> <Int256 as Add<Int256>>::Output

Performs the + operation.

impl Add for Int256

type Output = Int256

The resulting type after applying the + operator.

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

Performs the + operation.

impl AddAssign<&Int256> for Int256

fn add_assign(&mut self, other: &Int256)

Performs the += operation.

impl AddAssign for Int256

fn add_assign(&mut self, rhs: Int256)

Performs the += operation.

impl Clone for Int256

fn clone(&self) -> Int256

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Debug for Int256

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

Formats the value using the given formatter.

impl Default for Int256

fn default() -> Int256

Returns the “default value” for a type.

impl<'de> Deserialize<'de> for Int256

fn deserialize<D>(deserializer: D) -> Result<Self, D::Error>

where D: Deserializer<'de>,

Deserializes from an integer string using base 10.

See the Serialize documentation for a few more words on the encoding of the UintXXX/IntYYY family.

impl Display for Int256

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

Formats the value using the given formatter.

impl Div<&Int256> for &Int256

type Output = <Int256 as Div>::Output

The resulting type after applying the / operator.

fn div(self, other: &Int256) -> <Int256 as Div<Int256>>::Output

Performs the / operation.

impl Div<&Int256> for Int256

type Output = <Int256 as Div>::Output

The resulting type after applying the / operator.

fn div(self, other: &Int256) -> <Int256 as Div<Int256>>::Output

Performs the / operation.

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

type Output = <Int256 as Div>::Output

The resulting type after applying the / operator.

fn div(self, other: Int256) -> <Int256 as Div<Int256>>::Output

Performs the / operation.

impl Div<Int256> for SignedDecimal256

type Output = SignedDecimal256

The resulting type after applying the / operator.

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

Performs the / operation.

impl Div for Int256

type Output = Int256

The resulting type after applying the / operator.

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

Performs the / operation.

impl DivAssign<&Int256> for Int256

fn div_assign(&mut self, other: &Int256)

Performs the /= operation.

impl DivAssign<Int256> for SignedDecimal256

fn div_assign(&mut self, rhs: Int256)

Performs the /= operation.

impl DivAssign for Int256

fn div_assign(&mut self, rhs: Self)

Performs the /= operation.

impl Fraction<Int256> for SignedDecimal256

fn inv(&self) -> Option<Self>

Returns the multiplicative inverse 1/d for decimal d.

If d is zero, none is returned.

fn numerator(&self) -> Int256

Returns the numerator p

fn denominator(&self) -> Int256

Returns the denominator q

impl From<Int128> for Int256

fn from(val: Int128) -> Self

Converts to this type from the input type.

impl From<Int256> for Int512

fn from(val: Int256) -> Self

Converts to this type from the input type.

impl From<Int256> for String

fn from(original: Int256) -> Self

Converts to this type from the input type.

impl From<Int64> for Int256

fn from(val: Int64) -> Self

Converts to this type from the input type.

impl From<Uint128> for Int256

fn from(val: Uint128) -> Self

Converts to this type from the input type.

impl From<Uint64> for Int256

fn from(val: Uint64) -> Self

Converts to this type from the input type.

impl From<i128> for Int256

fn from(value: i128) -> Self

Converts to this type from the input type.

impl From<i16> for Int256

fn from(value: i16) -> Self

Converts to this type from the input type.

impl From<i32> for Int256

fn from(value: i32) -> Self

Converts to this type from the input type.

impl From<i64> for Int256

fn from(value: i64) -> Self

Converts to this type from the input type.

impl From<i8> for Int256

fn from(value: i8) -> Self

Converts to this type from the input type.

impl From<u128> for Int256

fn from(value: u128) -> Self

Converts to this type from the input type.

impl From<u16> for Int256

fn from(value: u16) -> Self

Converts to this type from the input type.

impl From<u32> for Int256

fn from(value: u32) -> Self

Converts to this type from the input type.

impl From<u64> for Int256

fn from(value: u64) -> Self

Converts to this type from the input type.

impl From<u8> for Int256

fn from(value: u8) -> Self

Converts to this type from the input type.

impl FromStr for Int256

type Err = StdError

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 JsonSchema for Int256

fn schema_name() -> String

The name of the generated JSON Schema.

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

Returns a string that uniquely identifies the schema produced by this type.

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

Generates a JSON Schema for this type.

fn is_referenceable() -> bool

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

impl Mul<&Int256> for &Int256

type Output = <Int256 as Mul>::Output

The resulting type after applying the * operator.

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

Performs the * operation.

impl Mul<&Int256> for Int256

type Output = <Int256 as Mul>::Output

The resulting type after applying the * operator.

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

Performs the * operation.

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

type Output = <Int256 as Mul>::Output

The resulting type after applying the * operator.

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

Performs the * operation.

impl Mul for Int256

type Output = Int256

The resulting type after applying the * operator.

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

Performs the * operation.

impl MulAssign<&Int256> for Int256

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

Performs the *= operation.

impl MulAssign for Int256

fn mul_assign(&mut self, rhs: Self)

Performs the *= operation.

impl Neg for Int256

type Output = Int256

The resulting type after applying the - operator.

fn neg(self) -> Self::Output

Performs the unary - operation.

impl Not for Int256

type Output = Int256

The resulting type after applying the ! operator.

fn not(self) -> Self::Output

Performs the unary ! operation.

impl Ord for Int256

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

fn eq(&self, rhs: &&Int256) -> 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<'a> PartialEq<Int256> for &'a Int256

fn eq(&self, rhs: &Int256) -> 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 PartialEq for Int256

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

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

type Output = <Int256 as Rem>::Output

The resulting type after applying the % operator.

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

Performs the % operation.

impl Rem<&Int256> for Int256

type Output = <Int256 as Rem>::Output

The resulting type after applying the % operator.

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

Performs the % operation.

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

type Output = <Int256 as Rem>::Output

The resulting type after applying the % operator.

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

Performs the % operation.

impl Rem for Int256

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

Panics

This operation will panic if rhs is zero.

type Output = Int256

The resulting type after applying the % operator.

impl RemAssign<&Int256> for Int256

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

Performs the %= operation.

impl RemAssign for Int256

fn rem_assign(&mut self, rhs: Int256)

Performs the %= operation.

impl Serialize for Int256

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

where S: Serializer,

Serializes as an integer string using base 10.

We consistently serialize all UintXXX and IntYYY types as strings in JSON to ensure the best possible compatibility with clients. E.g. JavaScript and jq only support up to ~53bit numbers without losing precision, making it hard to use serialized u64s on other systems than Rust or Go. Uint64/Int64 ensure the full 64 bit range is supported. For larger integers, the use of strings is pretty much the only reasonable way to store them in JSON.

For binary encodings (notably MessagePack) strings are used too. The reason is that in MessagePack integers are limited to 64 bit and we strive for consistent encoding within the UintXXX/IntYYY family. Also for small to mid sized values, decimal strings are often more compact than a fixed-length binary encoding.

Examples

Serialize to JSON:

let value = Uint64::new(17);
let serialized = to_json_vec(&value).unwrap();
assert_eq!(serialized, b"\"17\"");

Serialize to MessagePack:

let value = Uint64::new(17);
let serialized = to_msgpack_vec(&value).unwrap();
assert_eq!(serialized, [0b10100000 ^ 2, b'1', b'7']); // string of lengths 2 with value "17"

impl Shl<&u32> for &Int256

type Output = <Int256 as Shl<u32>>::Output

The resulting type after applying the << operator.

fn shl(self, other: &u32) -> <Int256 as Shl<u32>>::Output

Performs the << operation.

impl Shl<&u32> for Int256

type Output = <Int256 as Shl<u32>>::Output

The resulting type after applying the << operator.

fn shl(self, other: &u32) -> <Int256 as Shl<u32>>::Output

Performs the << operation.

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

type Output = <Int256 as Shl<u32>>::Output

The resulting type after applying the << operator.

fn shl(self, other: u32) -> <Int256 as Shl<u32>>::Output

Performs the << operation.

impl Shl<u32> for Int256

type Output = Int256

The resulting type after applying the << operator.

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

Performs the << operation.

impl ShlAssign<&u32> for Int256

fn shl_assign(&mut self, other: &u32)

Performs the <<= operation.

impl ShlAssign<u32> for Int256

fn shl_assign(&mut self, rhs: u32)

Performs the <<= operation.

impl Shr<&u32> for &Int256

type Output = <Int256 as Shr<u32>>::Output

The resulting type after applying the >> operator.

fn shr(self, other: &u32) -> <Int256 as Shr<u32>>::Output

Performs the >> operation.

impl Shr<&u32> for Int256

type Output = <Int256 as Shr<u32>>::Output

The resulting type after applying the >> operator.

fn shr(self, other: &u32) -> <Int256 as Shr<u32>>::Output

Performs the >> operation.

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

type Output = <Int256 as Shr<u32>>::Output

The resulting type after applying the >> operator.

fn shr(self, other: u32) -> <Int256 as Shr<u32>>::Output

Performs the >> operation.

impl Shr<u32> for Int256

type Output = Int256

The resulting type after applying the >> operator.

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

Performs the >> operation.

impl ShrAssign<&u32> for Int256

fn shr_assign(&mut self, other: &u32)

Performs the >>= operation.

impl ShrAssign<u32> for Int256

fn shr_assign(&mut self, rhs: u32)

Performs the >>= operation.

impl Sub<&Int256> for &Int256

type Output = <Int256 as Sub>::Output

The resulting type after applying the - operator.

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

Performs the - operation.

impl Sub<&Int256> for Int256

type Output = <Int256 as Sub>::Output

The resulting type after applying the - operator.

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

Performs the - operation.

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

type Output = <Int256 as Sub>::Output

The resulting type after applying the - operator.

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

Performs the - operation.

impl Sub for Int256

type Output = Int256

The resulting type after applying the - operator.

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

Performs the - operation.

impl SubAssign<&Int256> for Int256

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

Performs the -= operation.

impl SubAssign for Int256

fn sub_assign(&mut self, rhs: Int256)

Performs the -= operation.

impl<A> Sum<A> for Int256

where Self: Add<A, Output = Self>,

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

Takes an iterator and generates Self from the elements by “summing up” the items.

impl TryFrom<&str> for Int256

type Error = StdError

The type returned in the event of a conversion error.

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

Performs the conversion.

impl TryFrom<Int256> for Int128

type Error = ConversionOverflowError

The type returned in the event of a conversion error.

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

Performs the conversion.

impl TryFrom<Int256> for Int64

type Error = ConversionOverflowError

The type returned in the event of a conversion error.

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

Performs the conversion.

impl TryFrom<Int256> for SignedDecimal256

type Error = SignedDecimal256RangeExceeded

The type returned in the event of a conversion error.

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

Performs the conversion.

impl TryFrom<Int256> for Uint128

type Error = ConversionOverflowError

The type returned in the event of a conversion error.

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

Performs the conversion.

impl TryFrom<Int256> for Uint256

type Error = ConversionOverflowError

The type returned in the event of a conversion error.

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

Performs the conversion.

impl TryFrom<Int256> for Uint512

type Error = ConversionOverflowError

The type returned in the event of a conversion error.

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

Performs the conversion.

impl TryFrom<Int256> for Uint64

type Error = ConversionOverflowError

The type returned in the event of a conversion error.

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

Performs the conversion.

impl TryFrom<Int512> for Int256

type Error = ConversionOverflowError

The type returned in the event of a conversion error.

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

Performs the conversion.

impl TryFrom<Uint256> for Int256

type Error = ConversionOverflowError

The type returned in the event of a conversion error.

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

Performs the conversion.

impl TryFrom<Uint512> for Int256

type Error = ConversionOverflowError

The type returned in the event of a conversion error.

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

Performs the conversion.

impl Copy for Int256

impl Eq for Int256

impl StructuralPartialEq for Int256