Struct sp_arithmetic::rational::Rational128

pub struct Rational128(_, _);

A wrapper for any rational number with a 128 bit numerator and denominator.

Implementations

impl Rational128

pub fn zero() -> Self

Zero.

pub fn one() -> Self

One

pub fn is_zero(&self) -> bool

If it is zero or not

pub fn from(n: u128, d: u128) -> Self

Build from a raw n/d.

pub fn from_unchecked(n: u128, d: u128) -> Self

Build from a raw n/d. This could lead to / 0 if not properly handled.

pub fn n(&self) -> u128

Return the numerator.

pub fn d(&self) -> u128

Return the denominator.

pub fn to_den(self, den: u128) -> Option<Self>

Convert self to a similar rational number where denominator is the given den. This only returns if the result is accurate. None is returned if the result cannot be accurately calculated.

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

Get the least common divisor of self and other.

This only returns if the result is accurate. None is returned if the result cannot be accurately calculated.

pub fn lazy_saturating_add(self, other: Self) -> Self

A saturating add that assumes self and other have the same denominator.

pub fn lazy_saturating_sub(self, other: Self) -> Self

A saturating subtraction that assumes self and other have the same denominator.

pub fn checked_add(self, other: Self) -> Result<Self, &'static str>

Addition. Simply tries to unify the denominators and add the numerators.

Overflow might happen during any of the steps. Error is returned in such cases.

pub fn checked_sub(self, other: Self) -> Result<Self, &'static str>

Subtraction. Simply tries to unify the denominators and subtract the numerators.

Overflow might happen during any of the steps. None is returned in such cases.

Trait Implementations

impl Bounded for Rational128

fn min_value() -> Self

Returns the smallest finite number this type can represent

fn max_value() -> Self

Returns the largest finite number this type can represent

impl Clone for Rational128

fn clone(&self) -> Rational128

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Debug for Rational128

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

Formats the value using the given formatter.

impl Default for Rational128

fn default() -> Rational128

Returns the “default value” for a type.

impl From<Rational128> for RationalInfinite

fn from(t: Rational128) -> Self

Converts to this type from the input type.

impl<T: Into<u128>> From<T> for Rational128

fn from(t: T) -> Self

Converts to this type from the input type.

impl Ord for Rational128

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

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

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

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 Copy for Rational128

impl Eq for Rational128

impl StructuralEq for Rational128