Struct num256::uint256::Uint256

pub struct Uint256(pub BigUint);

Tuple Fields

0: BigUint

Implementations

impl Uint256

pub fn from_bytes_le(slice: &[u8]) -> Uint256

pub fn from_bytes_be(slice: &[u8]) -> Uint256

pub fn from_str_radix(s: &str, radix: u32) -> Result<Uint256, ParseBigIntError>

Methods from Deref<Target = BigUint>

pub fn to_bytes_be(&self) -> Vec<u8, Global>

Returns the byte representation of the BigUint in big-endian byte order.

Examples

use num_bigint::BigUint;

let i = BigUint::parse_bytes(b"1125", 10).unwrap();
assert_eq!(i.to_bytes_be(), vec![4, 101]);

pub fn to_bytes_le(&self) -> Vec<u8, Global>

Returns the byte representation of the BigUint in little-endian byte order.

Examples

use num_bigint::BigUint;

let i = BigUint::parse_bytes(b"1125", 10).unwrap();
assert_eq!(i.to_bytes_le(), vec![101, 4]);

pub fn to_u32_digits(&self) -> Vec<u32, Global>

Returns the u32 digits representation of the BigUint ordered least significant digit first.

Examples

use num_bigint::BigUint;

assert_eq!(BigUint::from(1125u32).to_u32_digits(), vec![1125]);
assert_eq!(BigUint::from(4294967295u32).to_u32_digits(), vec![4294967295]);
assert_eq!(BigUint::from(4294967296u64).to_u32_digits(), vec![0, 1]);
assert_eq!(BigUint::from(112500000000u64).to_u32_digits(), vec![830850304, 26]);

pub fn to_str_radix(&self, radix: u32) -> String

Returns the integer formatted as a string in the given radix. radix must be in the range 2...36.

Examples

use num_bigint::BigUint;

let i = BigUint::parse_bytes(b"ff", 16).unwrap();
assert_eq!(i.to_str_radix(16), "ff");

pub fn to_radix_be(&self, radix: u32) -> Vec<u8, Global>

Returns the integer in the requested base in big-endian digit order. The output is not given in a human readable alphabet but as a zero based u8 number. radix must be in the range 2...256.

Examples

use num_bigint::BigUint;

assert_eq!(BigUint::from(0xFFFFu64).to_radix_be(159),
           vec![2, 94, 27]);
// 0xFFFF = 65535 = 2*(159^2) + 94*159 + 27

pub fn to_radix_le(&self, radix: u32) -> Vec<u8, Global>

Returns the integer in the requested base in little-endian digit order. The output is not given in a human readable alphabet but as a zero based u8 number. radix must be in the range 2...256.

Examples

use num_bigint::BigUint;

assert_eq!(BigUint::from(0xFFFFu64).to_radix_le(159),
           vec![27, 94, 2]);
// 0xFFFF = 65535 = 27 + 94*159 + 2*(159^2)

pub fn bits(&self) -> usize

Determines the fewest bits necessary to express the BigUint.

pub fn modpow(&self, exponent: &BigUint, modulus: &BigUint) -> BigUint

Returns (self ^ exponent) % modulus.

Panics if the modulus is zero.

pub fn sqrt(&self) -> BigUint

Returns the truncated principal square root of self – see Roots::sqrt

pub fn cbrt(&self) -> BigUint

Returns the truncated principal cube root of self – see Roots::cbrt.

pub fn nth_root(&self, n: u32) -> BigUint

Returns the truncated principal nth root of self – see Roots::nth_root.

Trait Implementations

impl<T> Add<T> for Uint256where
    T: Into<Uint256>,

type Output = Uint256

The resulting type after applying the + operator.

fn add(self, v: T) -> Uint256

Performs the + operation.

impl<T> AddAssign<T> for Uint256where
    T: Into<Uint256>,

fn add_assign(&mut self, v: T)

Performs the += operation.

impl CheckedAdd for Uint256

fn checked_add(&self, v: &Uint256) -> Option<Uint256>

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

impl CheckedDiv for Uint256

fn checked_div(&self, v: &Uint256) -> Option<Uint256>

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

impl CheckedMul for Uint256

fn checked_mul(&self, v: &Uint256) -> Option<Uint256>

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

impl CheckedSub for Uint256

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

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

impl Clone for Uint256

fn clone(&self) -> Uint256

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Debug for Uint256

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

Formats the value using the given formatter.

impl Deref for Uint256

type Target = BigUint

The resulting type after dereferencing.

fn deref(&self) -> &BigUint

Dereferences the value.

impl<'de> Deserialize<'de> for Uint256

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

Deserialize this value from the given Serde deserializer.

impl Display for Uint256

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

Formats the value using the given formatter.

impl<T> Div<T> for Uint256where
    T: Into<Uint256>,

type Output = Uint256

The resulting type after applying the / operator.

fn div(self, v: T) -> Uint256

Performs the / operation.

impl<T> DivAssign<T> for Uint256where
    T: Into<Uint256>,

fn div_assign(&mut self, v: T)

Performs the /= operation.

impl<'a> From<&'a [u8]> for Uint256

fn from(n: &'a [u8]) -> Uint256

Converts to this type from the input type.

impl<'a> From<&'a Uint256> for Int256

fn from(n: &Uint256) -> Int256

Converts to this type from the input type.

impl From<[u8; 32]> for Uint256

fn from(n: [u8; 32]) -> Uint256

Converts to this type from the input type.

impl From<Int256> for Uint256

fn from(n: Int256) -> Self

Converts to this type from the input type.

impl From<Uint256> for Int256

fn from(n: Uint256) -> Self

Converts to this type from the input type.

impl From<i16> for Uint256

fn from(n: i16) -> Self

Converts to this type from the input type.

impl From<i32> for Uint256

fn from(n: i32) -> Self

Converts to this type from the input type.

impl From<i64> for Uint256

fn from(n: i64) -> Self

Converts to this type from the input type.

impl From<i8> for Uint256

fn from(n: i8) -> Self

Converts to this type from the input type.

impl From<isize> for Uint256

fn from(n: isize) -> Self

Converts to this type from the input type.

impl From<u16> for Uint256

fn from(n: u16) -> Self

Converts to this type from the input type.

impl From<u32> for Uint256

fn from(n: u32) -> Self

Converts to this type from the input type.

impl From<u64> for Uint256

fn from(n: u64) -> Self

Converts to this type from the input type.

impl From<u8> for Uint256

fn from(n: u8) -> Self

Converts to this type from the input type.

impl From<usize> for Uint256

fn from(n: usize) -> Self

Converts to this type from the input type.

impl FromStr for Uint256

type Err = Error

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 Hash for Uint256

fn hash<__H: Hasher>(&self, state: &mut __H)

Feeds this value into the given Hasher.

fn hash_slice<H>(data: &[Self], state: &mut H)where
    H: Hasher,
    Self: Sized,

Feeds a slice of this type into the given Hasher.

impl Into<[u8; 32]> for Uint256

fn into(self) -> [u8; 32]

Converts this type into the (usually inferred) input type.

impl LowerHex for Uint256

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

Formats the value using the given formatter.

impl<T> Mul<T> for Uint256where
    T: Into<Uint256>,

type Output = Uint256

The resulting type after applying the * operator.

fn mul(self, v: T) -> Uint256

Performs the * operation.

impl<T> MulAssign<T> for Uint256where
    T: Into<Uint256>,

fn mul_assign(&mut self, v: T)

Performs the *= operation.

impl Ord for Uint256

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

This method returns an Ordering between self and other.

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

Compares and returns the maximum of two values.

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

Compares and returns the minimum of two values.

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

Restrict a value to a certain interval.

impl PartialEq<Uint256> for Uint256

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

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

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

Serialize this value into the given Serde serializer.

impl<T> Sub<T> for Uint256where
    T: Into<Uint256>,

type Output = Uint256

The resulting type after applying the - operator.

fn sub(self, v: T) -> Uint256

Performs the - operation.

impl<T> SubAssign<T> for Uint256where
    T: Into<Uint256>,

fn sub_assign(&mut self, v: T)

Performs the -= operation.

impl UpperHex for Uint256

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

Formats the value using the given formatter.

impl Zero for Uint256

fn zero() -> Uint256

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 Eq for Uint256

impl StructuralEq for Uint256

impl StructuralPartialEq for Uint256