Struct BigRational 

pub struct BigRational { /* private fields */ }

Exact rational number with arbitrary-precision numerator and denominator.

Implementations

impl BigRational

pub fn zero() -> Self

The rational zero (0/1).

pub fn one() -> Self

The rational one (1/1).

pub fn from_bigint(n: BigInt) -> Self

Construct from a BigInt (n/1).

pub fn from_i64(n: i64) -> Self

Construct from an i64 (n/1).

pub fn from_i64s(num: i64, den: i64) -> Option<Self>

Construct from a numerator/denominator pair of i64. Fails closed on a zero denominator.

pub fn new(num: BigInt, den: BigInt) -> Option<Self>

Construct from arbitrary BigInt numerator and denominator, reducing and sign-normalising. Returns None if den is zero.

pub fn numerator(&self) -> &BigInt

Numerator (sign-bearing).

pub fn denominator(&self) -> &BigInt

Denominator (always positive).

pub fn is_zero(&self) -> bool

True if this is exactly zero.

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 recip(&self) -> Option<Self>

Multiplicative inverse den/num. Fails closed if self is zero.

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

Sum self + other. Computes (a*d + c*b) / (b*d) then reduces.

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

Difference self - other.

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

Product self * other.

pub fn div(&self, other: &BigRational) -> Option<BigRational>

Quotient self / other. Fails closed if other is zero.

pub fn to_f64(&self) -> f64

Convert to the nearest f64. (Exact for small values; rounded otherwise.)

Trait Implementations

impl Clone for BigRational

fn clone(&self) -> BigRational

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for BigRational

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

Formats the value using the given formatter.

impl Display for BigRational

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

Formats the value using the given formatter.

impl Ord for BigRational

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 BigRational

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

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 BigRational

impl StructuralPartialEq for BigRational