Struct BigInt 

pub struct BigInt { /* private fields */ }

An exact, arbitrary-precision integer.

Implementations

impl BigInt

pub fn zero() -> Self

The additive identity.

pub fn from_i64(x: i64) -> Self

Exact widening from a machine integer.

pub fn from_u64(x: u64) -> Self

Exact widening from an unsigned machine integer.

pub fn to_i64(&self) -> Option<i64>

Narrow back to an i64 iff the value fits — the basis of the “downsize when it provably fits” path the runtime uses to stay on the fast i64 repr.

pub fn is_zero(&self) -> bool

pub fn is_odd(&self) -> bool

Parity (the low bit of the magnitude — sign does not change it). Zero is even.

pub fn to_f64(&self) -> f64

Nearest f64 (lossy by nature — float semantics) for mixed int/float math.

pub fn is_negative(&self) -> bool

pub fn is_positive(&self) -> bool

pub fn abs(&self) -> Self

The absolute value.

pub fn negated(&self) -> Self

Additive inverse.

pub fn add(&self, other: &Self) -> Self

self + other.

pub fn sub(&self, other: &Self) -> Self

self - other.

pub fn mul(&self, other: &Self) -> Self

self * other.

pub fn div_rem(&self, other: &Self) -> Option<(Self, Self)>

Truncated division toward zero: returns (quotient, remainder) with self = q*other + r and the remainder carrying the dividend’s sign — exactly matching Rust/i64 / and %, so the wide type is a drop-in for the narrow. None when other is zero.

pub fn parse_decimal(s: &str) -> Option<Self>

Parse a base-10 integer (optional leading +/-). None on any non-digit.

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

self raised to a non-negative integer power, by exponentiation-by-squaring (0^0 == 1). Exact and unbounded — 2.pow(63) is the value i64 cannot hold.

pub fn to_le_bytes(&self) -> (bool, Vec<u8>)

Sign + little-endian magnitude bytes — a compact, exact serialization (the inverse of BigInt::from_le_bytes). The wire ships these instead of a decimal string, so there is no base conversion and no precision question.

pub fn from_le_bytes(negative: bool, bytes: &[u8]) -> Self

Reconstruct from a sign flag and little-endian magnitude bytes (length need not be a multiple of 8; trailing zero limbs are normalized away).

Trait Implementations

impl Clone for BigInt

fn clone(&self) -> BigInt

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for BigInt

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

Formats the value using the given formatter.

impl Display for BigInt

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

Formats the value using the given formatter.

impl From<BigInt> for Decimal

fn from(x: BigInt) -> Self

Converts to this type from the input type.

impl From<BigInt> for Rational

fn from(x: BigInt) -> Self

Converts to this type from the input type.

impl From<i64> for BigInt

fn from(x: i64) -> Self

Converts to this type from the input type.

impl Hash for BigInt

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 Ord for BigInt

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

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

fn partial_cmp(&self, other: &Self) -> 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 Eq for BigInt

impl StructuralPartialEq for BigInt