Struct BigInt 

pub struct BigInt { /* private fields */ }

Arbitrary-precision signed integer.

Implementations

impl BigInt

pub fn zero() -> Self

The integer zero.

pub fn one() -> Self

The integer one.

pub fn from_i64(v: i64) -> Self

Construct from an i64.

pub fn from_u64(v: u64) -> Self

Construct from a u64.

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

Parse a decimal string (optional leading +/-). Fails closed on any non-digit character or empty input.

pub fn to_string(&self) -> String

Render as a decimal string with a leading - for negatives.

pub fn is_zero(&self) -> bool

True if this is zero.

pub fn is_negative(&self) -> bool

True if this is negative.

pub fn signum(&self) -> i8

Sign: -1, 0, or +1.

pub fn abs(&self) -> Self

Absolute value.

pub fn neg(&self) -> Self

Arithmetic negation.

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

Sum self + other.

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

Difference self - other.

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

Product self * other.

pub fn divmod(&self, divisor: &BigInt) -> Option<(BigInt, BigInt)>

Truncated division and remainder: returns (quotient, remainder) such that self == quotient * divisor + remainder, with the remainder taking the sign of self (truncation toward zero, matching Rust’s / and % on primitive integers). Fails closed (None) on division by zero.

pub fn div(&self, divisor: &BigInt) -> Option<BigInt>

Quotient only (truncated toward zero). Fails closed on zero divisor.

pub fn rem(&self, divisor: &BigInt) -> Option<BigInt>

Remainder only (sign of self). Fails closed on zero divisor.

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

Raise to a non-negative integer power (exponentiation by squaring).

pub fn gcd(&self, other: &BigInt) -> BigInt

Greatest common divisor (always non-negative). gcd(0,0) == 0.

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 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