Struct scrypto::math::bnum_integer::U256
source · #[repr(transparent)]pub struct U256(pub BUint<4>);
Expand description
Provides safe integer arithmetic.
Operations like +
, ‘-’, ‘*’, or ‘/’ sometimes produce overflow
which is detected and results in a panic, in of silently
wrapping around.
The bit length of output type will be the greater one in the math operation, and if any of the types was signed, then the resulting type will be signed too, otherwise the output type is unsigned.
The underlying value can be retrieved through the .0
index of the
U256
tuple.
§Layout
U256
will have the same methods and traits as
the built-in counterpart.
Tuple Fields§
§0: BUint<4>
Implementations§
source§impl U256
impl U256
sourcepub const fn count_ones(self) -> u32
pub const fn count_ones(self) -> u32
Returns the number of ones in the binary representation of self
.
sourcepub const fn count_zeros(self) -> u32
pub const fn count_zeros(self) -> u32
Returns the number of zeros in the binary representation of self
.
sourcepub const fn trailing_zeros(self) -> u32
pub const fn trailing_zeros(self) -> u32
Returns the number of trailing zeros in the binary representation of self
.
sourcepub const fn swap_bytes(self) -> U256
pub const fn swap_bytes(self) -> U256
Reverses the byte order of the integer.
sourcepub const fn reverse_bits(self) -> U256
pub const fn reverse_bits(self) -> U256
Reverses the bit pattern of the integer.
sourcepub const fn leading_zeros(self) -> u32
pub const fn leading_zeros(self) -> u32
Returns the number of leading zeros in the binary representation of self
.
sourcepub const fn from_be(x: U256) -> U256
pub const fn from_be(x: U256) -> U256
Converts an integer from big endian to the target’s endianness.
On big endian this is a no-op. On little endian the bytes are swapped.
sourcepub const fn from_le(x: U256) -> U256
pub const fn from_le(x: U256) -> U256
Converts an integer from little endian to the target’s endianness.
On little endian this is a no-op. On big endian the bytes are swapped.
source§impl U256
impl U256
pub fn is_power_of_two(self) -> bool
pub fn next_power_of_two(self) -> U256
Trait Implementations§
source§impl Add<PreciseDecimal> for U256
impl Add<PreciseDecimal> for U256
§type Output = PreciseDecimal
type Output = PreciseDecimal
+
operator.source§fn add(self, other: PreciseDecimal) -> <U256 as Add<PreciseDecimal>>::Output
fn add(self, other: PreciseDecimal) -> <U256 as Add<PreciseDecimal>>::Output
+
operation. Read moresource§impl Add<U256> for PreciseDecimal
impl Add<U256> for PreciseDecimal
source§impl AddAssign<&U256> for U256
impl AddAssign<&U256> for U256
source§fn add_assign(&mut self, other: &U256)
fn add_assign(&mut self, other: &U256)
+=
operation. Read moresource§impl AddAssign<U256> for Decimal
impl AddAssign<U256> for Decimal
source§fn add_assign(&mut self, other: U256)
fn add_assign(&mut self, other: U256)
+=
operation. Read moresource§impl AddAssign<U256> for PreciseDecimal
impl AddAssign<U256> for PreciseDecimal
source§fn add_assign(&mut self, other: U256)
fn add_assign(&mut self, other: U256)
+=
operation. Read moresource§impl AddAssign for U256
impl AddAssign for U256
source§fn add_assign(&mut self, other: U256)
fn add_assign(&mut self, other: U256)
+=
operation. Read moresource§impl BitAndAssign for U256
impl BitAndAssign for U256
source§fn bitand_assign(&mut self, other: U256)
fn bitand_assign(&mut self, other: U256)
&=
operation. Read moresource§impl BitOrAssign for U256
impl BitOrAssign for U256
source§fn bitor_assign(&mut self, other: U256)
fn bitor_assign(&mut self, other: U256)
|=
operation. Read moresource§impl BitXorAssign for U256
impl BitXorAssign for U256
source§fn bitxor_assign(&mut self, other: U256)
fn bitxor_assign(&mut self, other: U256)
^=
operation. Read moresource§impl CheckedAdd<Decimal> for U256
impl CheckedAdd<Decimal> for U256
source§impl CheckedAdd<PreciseDecimal> for U256
impl CheckedAdd<PreciseDecimal> for U256
type Output = PreciseDecimal
fn checked_add( self, other: PreciseDecimal ) -> Option<<U256 as CheckedAdd<PreciseDecimal>>::Output>
source§impl CheckedAdd<U256> for Decimal
impl CheckedAdd<U256> for Decimal
source§impl CheckedAdd<U256> for PreciseDecimal
impl CheckedAdd<U256> for PreciseDecimal
type Output = PreciseDecimal
fn checked_add( self, other: U256 ) -> Option<<PreciseDecimal as CheckedAdd<U256>>::Output>
source§impl CheckedAdd for U256
impl CheckedAdd for U256
source§impl CheckedDiv<Decimal> for U256
impl CheckedDiv<Decimal> for U256
source§impl CheckedDiv<PreciseDecimal> for U256
impl CheckedDiv<PreciseDecimal> for U256
type Output = PreciseDecimal
fn checked_div( self, other: PreciseDecimal ) -> Option<<U256 as CheckedDiv<PreciseDecimal>>::Output>
source§impl CheckedDiv<U256> for Decimal
impl CheckedDiv<U256> for Decimal
source§impl CheckedDiv<U256> for PreciseDecimal
impl CheckedDiv<U256> for PreciseDecimal
type Output = PreciseDecimal
fn checked_div( self, other: U256 ) -> Option<<PreciseDecimal as CheckedDiv<U256>>::Output>
source§impl CheckedDiv for U256
impl CheckedDiv for U256
source§impl CheckedMul<Decimal> for U256
impl CheckedMul<Decimal> for U256
source§impl CheckedMul<PreciseDecimal> for U256
impl CheckedMul<PreciseDecimal> for U256
type Output = PreciseDecimal
fn checked_mul( self, other: PreciseDecimal ) -> Option<<U256 as CheckedMul<PreciseDecimal>>::Output>
source§impl CheckedMul<U256> for Decimal
impl CheckedMul<U256> for Decimal
source§impl CheckedMul<U256> for PreciseDecimal
impl CheckedMul<U256> for PreciseDecimal
type Output = PreciseDecimal
fn checked_mul( self, other: U256 ) -> Option<<PreciseDecimal as CheckedMul<U256>>::Output>
source§impl CheckedMul for U256
impl CheckedMul for U256
source§impl CheckedSub<Decimal> for U256
impl CheckedSub<Decimal> for U256
source§impl CheckedSub<PreciseDecimal> for U256
impl CheckedSub<PreciseDecimal> for U256
type Output = PreciseDecimal
fn checked_sub( self, other: PreciseDecimal ) -> Option<<U256 as CheckedSub<PreciseDecimal>>::Output>
source§impl CheckedSub<U256> for Decimal
impl CheckedSub<U256> for Decimal
source§impl CheckedSub<U256> for PreciseDecimal
impl CheckedSub<U256> for PreciseDecimal
type Output = PreciseDecimal
fn checked_sub( self, other: U256 ) -> Option<<PreciseDecimal as CheckedSub<U256>>::Output>
source§impl CheckedSub for U256
impl CheckedSub for U256
source§impl Div<PreciseDecimal> for U256
impl Div<PreciseDecimal> for U256
§type Output = PreciseDecimal
type Output = PreciseDecimal
/
operator.source§fn div(self, other: PreciseDecimal) -> <U256 as Div<PreciseDecimal>>::Output
fn div(self, other: PreciseDecimal) -> <U256 as Div<PreciseDecimal>>::Output
/
operation. Read moresource§impl Div<U256> for PreciseDecimal
impl Div<U256> for PreciseDecimal
source§impl DivAssign<&U256> for U256
impl DivAssign<&U256> for U256
source§fn div_assign(&mut self, other: &U256)
fn div_assign(&mut self, other: &U256)
/=
operation. Read moresource§impl DivAssign<U256> for Decimal
impl DivAssign<U256> for Decimal
source§fn div_assign(&mut self, other: U256)
fn div_assign(&mut self, other: U256)
/=
operation. Read moresource§impl DivAssign<U256> for PreciseDecimal
impl DivAssign<U256> for PreciseDecimal
source§fn div_assign(&mut self, other: U256)
fn div_assign(&mut self, other: U256)
/=
operation. Read moresource§impl DivAssign for U256
impl DivAssign for U256
source§fn div_assign(&mut self, other: U256)
fn div_assign(&mut self, other: U256)
/=
operation. Read moresource§impl FromPrimitive for U256
impl FromPrimitive for U256
source§fn from_u8(n: u8) -> Option<U256>
fn from_u8(n: u8) -> Option<U256>
u8
to return an optional value of this type. If the
value cannot be represented by this type, then None
is returned.source§fn from_u16(n: u16) -> Option<U256>
fn from_u16(n: u16) -> Option<U256>
u16
to return an optional value of this type. If the
value cannot be represented by this type, then None
is returned.source§fn from_u32(n: u32) -> Option<U256>
fn from_u32(n: u32) -> Option<U256>
u32
to return an optional value of this type. If the
value cannot be represented by this type, then None
is returned.source§fn from_u64(n: u64) -> Option<U256>
fn from_u64(n: u64) -> Option<U256>
u64
to return an optional value of this type. If the
value cannot be represented by this type, then None
is returned.source§fn from_u128(n: u128) -> Option<U256>
fn from_u128(n: u128) -> Option<U256>
u128
to return an optional value of this type. If the
value cannot be represented by this type, then None
is returned. Read moresource§fn from_usize(n: usize) -> Option<U256>
fn from_usize(n: usize) -> Option<U256>
usize
to return an optional value of this type. If the
value cannot be represented by this type, then None
is returned.source§fn from_i8(n: i8) -> Option<U256>
fn from_i8(n: i8) -> Option<U256>
i8
to return an optional value of this type. If the
value cannot be represented by this type, then None
is returned.source§fn from_i16(n: i16) -> Option<U256>
fn from_i16(n: i16) -> Option<U256>
i16
to return an optional value of this type. If the
value cannot be represented by this type, then None
is returned.source§fn from_i32(n: i32) -> Option<U256>
fn from_i32(n: i32) -> Option<U256>
i32
to return an optional value of this type. If the
value cannot be represented by this type, then None
is returned.source§fn from_i64(n: i64) -> Option<U256>
fn from_i64(n: i64) -> Option<U256>
i64
to return an optional value of this type. If the
value cannot be represented by this type, then None
is returned.source§fn from_i128(n: i128) -> Option<U256>
fn from_i128(n: i128) -> Option<U256>
i128
to return an optional value of this type. If the
value cannot be represented by this type, then None
is returned. Read moresource§fn from_isize(n: isize) -> Option<U256>
fn from_isize(n: isize) -> Option<U256>
isize
to return an optional value of this type. If the
value cannot be represented by this type, then None
is returned.source§impl Mul<PreciseDecimal> for U256
impl Mul<PreciseDecimal> for U256
§type Output = PreciseDecimal
type Output = PreciseDecimal
*
operator.source§fn mul(self, other: PreciseDecimal) -> <U256 as Mul<PreciseDecimal>>::Output
fn mul(self, other: PreciseDecimal) -> <U256 as Mul<PreciseDecimal>>::Output
*
operation. Read moresource§impl Mul<U256> for PreciseDecimal
impl Mul<U256> for PreciseDecimal
source§impl MulAssign<&U256> for U256
impl MulAssign<&U256> for U256
source§fn mul_assign(&mut self, other: &U256)
fn mul_assign(&mut self, other: &U256)
*=
operation. Read moresource§impl MulAssign<U256> for Decimal
impl MulAssign<U256> for Decimal
source§fn mul_assign(&mut self, other: U256)
fn mul_assign(&mut self, other: U256)
*=
operation. Read moresource§impl MulAssign<U256> for PreciseDecimal
impl MulAssign<U256> for PreciseDecimal
source§fn mul_assign(&mut self, other: U256)
fn mul_assign(&mut self, other: U256)
*=
operation. Read moresource§impl MulAssign for U256
impl MulAssign for U256
source§fn mul_assign(&mut self, other: U256)
fn mul_assign(&mut self, other: U256)
*=
operation. Read moresource§impl Ord for U256
impl Ord for U256
source§impl PartialEq for U256
impl PartialEq for U256
source§impl PartialOrd for U256
impl PartialOrd for U256
1.0.0 · source§fn le(&self, other: &Rhs) -> bool
fn le(&self, other: &Rhs) -> bool
self
and other
) and is used by the <=
operator. Read moresource§impl RemAssign<&U256> for U256
impl RemAssign<&U256> for U256
source§fn rem_assign(&mut self, other: &U256)
fn rem_assign(&mut self, other: &U256)
%=
operation. Read moresource§impl RemAssign for U256
impl RemAssign for U256
source§fn rem_assign(&mut self, other: U256)
fn rem_assign(&mut self, other: U256)
%=
operation. Read moresource§impl ShlAssign<u32> for U256
impl ShlAssign<u32> for U256
source§fn shl_assign(&mut self, other: u32)
fn shl_assign(&mut self, other: u32)
<<=
operation. Read moresource§impl ShrAssign<u32> for U256
impl ShrAssign<u32> for U256
source§fn shr_assign(&mut self, other: u32)
fn shr_assign(&mut self, other: u32)
>>=
operation. Read moresource§impl Sub<PreciseDecimal> for U256
impl Sub<PreciseDecimal> for U256
§type Output = PreciseDecimal
type Output = PreciseDecimal
-
operator.source§fn sub(self, other: PreciseDecimal) -> <U256 as Sub<PreciseDecimal>>::Output
fn sub(self, other: PreciseDecimal) -> <U256 as Sub<PreciseDecimal>>::Output
-
operation. Read moresource§impl Sub<U256> for PreciseDecimal
impl Sub<U256> for PreciseDecimal
source§impl SubAssign<&U256> for U256
impl SubAssign<&U256> for U256
source§fn sub_assign(&mut self, other: &U256)
fn sub_assign(&mut self, other: &U256)
-=
operation. Read moresource§impl SubAssign<U256> for Decimal
impl SubAssign<U256> for Decimal
source§fn sub_assign(&mut self, other: U256)
fn sub_assign(&mut self, other: U256)
-=
operation. Read moresource§impl SubAssign<U256> for PreciseDecimal
impl SubAssign<U256> for PreciseDecimal
source§fn sub_assign(&mut self, other: U256)
fn sub_assign(&mut self, other: U256)
-=
operation. Read moresource§impl SubAssign for U256
impl SubAssign for U256
source§fn sub_assign(&mut self, other: U256)
fn sub_assign(&mut self, other: U256)
-=
operation. Read moresource§impl ToPrimitive for U256
impl ToPrimitive for U256
source§fn to_u8(&self) -> Option<u8>
fn to_u8(&self) -> Option<u8>
self
to a u8
. If the value cannot be
represented by a u8
, then None
is returned.source§fn to_u16(&self) -> Option<u16>
fn to_u16(&self) -> Option<u16>
self
to a u16
. If the value cannot be
represented by a u16
, then None
is returned.source§fn to_u32(&self) -> Option<u32>
fn to_u32(&self) -> Option<u32>
self
to a u32
. If the value cannot be
represented by a u32
, then None
is returned.source§fn to_u64(&self) -> Option<u64>
fn to_u64(&self) -> Option<u64>
self
to a u64
. If the value cannot be
represented by a u64
, then None
is returned.source§fn to_u128(&self) -> Option<u128>
fn to_u128(&self) -> Option<u128>
self
to a u128
. If the value cannot be
represented by a u128
(u64
under the default implementation), then
None
is returned. Read moresource§fn to_usize(&self) -> Option<usize>
fn to_usize(&self) -> Option<usize>
self
to a usize
. If the value cannot be
represented by a usize
, then None
is returned.source§fn to_i8(&self) -> Option<i8>
fn to_i8(&self) -> Option<i8>
self
to an i8
. If the value cannot be
represented by an i8
, then None
is returned.source§fn to_i16(&self) -> Option<i16>
fn to_i16(&self) -> Option<i16>
self
to an i16
. If the value cannot be
represented by an i16
, then None
is returned.source§fn to_i32(&self) -> Option<i32>
fn to_i32(&self) -> Option<i32>
self
to an i32
. If the value cannot be
represented by an i32
, then None
is returned.source§fn to_i64(&self) -> Option<i64>
fn to_i64(&self) -> Option<i64>
self
to an i64
. If the value cannot be
represented by an i64
, then None
is returned.source§fn to_i128(&self) -> Option<i128>
fn to_i128(&self) -> Option<i128>
self
to an i128
. If the value cannot be
represented by an i128
(i64
under the default implementation), then
None
is returned. Read moresource§fn to_isize(&self) -> Option<isize>
fn to_isize(&self) -> Option<isize>
self
to an isize
. If the value cannot be
represented by an isize
, then None
is returned.source§impl TryFrom<U256> for PreciseDecimal
impl TryFrom<U256> for PreciseDecimal
§type Error = ParsePreciseDecimalError
type Error = ParsePreciseDecimalError
source§fn try_from(
val: U256
) -> Result<PreciseDecimal, <PreciseDecimal as TryFrom<U256>>::Error>
fn try_from( val: U256 ) -> Result<PreciseDecimal, <PreciseDecimal as TryFrom<U256>>::Error>
impl Copy for U256
impl Eq for U256
Auto Trait Implementations§
impl RefUnwindSafe for U256
impl Send for U256
impl Sync for U256
impl Unpin for U256
impl UnwindSafe for U256
Blanket Implementations§
§impl<U> As for U
impl<U> As for U
§fn as_<T>(self) -> Twhere
T: CastFrom<U>,
fn as_<T>(self) -> Twhere
T: CastFrom<U>,
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 moresource§impl<T> BorrowMut<T> for Twhere
T: ?Sized,
impl<T> BorrowMut<T> for Twhere
T: ?Sized,
source§fn borrow_mut(&mut self) -> &mut T
fn borrow_mut(&mut self) -> &mut T
source§impl<Q, K> Equivalent<K> for Q
impl<Q, K> Equivalent<K> for Q
source§fn equivalent(&self, key: &K) -> bool
fn equivalent(&self, key: &K) -> bool
key
and return true
if they are equal.