Struct Frac

pub struct Frac { /* private fields */ }

Representation of fractional value.

Implementations

impl Frac

pub const fn is_positive(&self) -> bool

pub const fn is_negative(&self) -> bool

pub const fn numer(&self) -> u128

pub const fn denom(&self) -> u128

pub const fn exp2(&self) -> i16

pub const fn exp5(&self) -> i16

pub const fn exp_pi(&self) -> i16

pub const fn new( neg: bool, numer: u128, denom: u128, exp2: i16, exp5: i16, exp_pi: i16, ) -> Self

for internal use.

pub const fn from_int(i: i128) -> Self

pub const fn from_exp10(exp10: i16) -> Self

pub const fn from_exp_pi(exp_pi: i16) -> Self

pub const fn from_ratio(numer: i128, denom: u128, exp10: i16) -> Self

pub const fn from_f64(d: f64) -> Self

pub const fn regularize(self) -> Self

pub const fn recip(self) -> Self

panic

When ‘numer’ is zero, this method goes into panic.

pub const fn add(self, rhs: Self) -> Self

let a = Frac::from_int(3_14) * Frac::from_exp10(-2);
let b = Frac::from_int(86) * Frac::from_exp10(-2);

assert_eq!(a + b, Frac::from_int(4));

pub const fn sub(self, rhs: Self) -> Self

let left = Frac::from_int(348_051856) * Frac::from_exp10(-6);
let right = Frac::from_int(334_133017) * Frac::from_exp10(-6);
let diff = left - right;

assert_eq!(
    diff,
    Frac::from_int(13_918839) * Frac::from_exp10(-6),
);

pub const fn mul(self, rhs: Self) -> Self

pub const fn div(self, rhs: Self) -> Self

panic

When ‘rhs.numer’ is zero, this method goes into panic.

pub const fn neg(self) -> Self

pub const fn powi(self, exp: i16) -> Self

let pi = Frac::from_int(314) * Frac::from_exp10(-2);
let pi2 = pi.powi(2);

assert_eq!(pi2.to_f64(), 3.14f64.powi(2));

panic

When ‘self.numer == 0 && exp < 0’, this method goes into panic.

pub const fn to_f64(self) -> f64

pub const fn to_ratio(self) -> Result<(i128, NonZeroI128), Error>

pub const fn to_rational128(self) -> Ratio<i128>

Trait Implementations

impl Add<&Frac> for Frac

type Output = Frac

The resulting type after applying the + operator.

fn add(self, rhs: &Self) -> Self

Performs the + operation.

impl Add for Frac

type Output = Frac

The resulting type after applying the + operator.

fn add(self, rhs: Self) -> Self

Performs the + operation.

impl AddAssign<&Frac> for Frac

fn add_assign(&mut self, rhs: &Self)

Performs the += operation.

impl AddAssign for Frac

fn add_assign(&mut self, rhs: Self)

Performs the += operation.

impl Clone for Frac

fn clone(&self) -> Frac

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Debug for Frac

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

Formats the value using the given formatter.

impl Default for Frac

fn default() -> Self

Returns the “default value” for a type.

impl Div<&Frac> for Frac

type Output = Frac

The resulting type after applying the / operator.

fn div(self, rhs: &Self) -> Self

Performs the / operation.

impl Div for Frac

type Output = Frac

The resulting type after applying the / operator.

fn div(self, rhs: Self) -> Self

Performs the / operation.

impl DivAssign<&Frac> for Frac

fn div_assign(&mut self, rhs: &Self)

Performs the /= operation.

impl DivAssign for Frac

fn div_assign(&mut self, rhs: Self)

Performs the /= operation.

impl From<f64> for Frac

fn from(d: f64) -> Self

Converts to this type from the input type.

impl FromStr for Frac

type Err = StringStreamError

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 Frac

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<T> Into<Ratio<T>> for Frac

where T: Clone + Debug + From<i128> + Integer,

fn into(self) -> Ratio<T>

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

impl Into<f64> for Frac

fn into(self) -> f64

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

impl Mul<&Frac> for Frac

type Output = Frac

The resulting type after applying the * operator.

fn mul(self, rhs: &Self) -> Self

Performs the * operation.

impl Mul for Frac

type Output = Frac

The resulting type after applying the * operator.

fn mul(self, rhs: Self) -> Self

Performs the * operation.

impl MulAssign<&Frac> for Frac

fn mul_assign(&mut self, rhs: &Self)

Performs the *= operation.

impl MulAssign for Frac

fn mul_assign(&mut self, rhs: Self)

Performs the *= operation.

impl Neg for Frac

type Output = Frac

The resulting type after applying the - operator.

fn neg(self) -> Self::Output

Performs the unary - operation.

impl Ord for Frac

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

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

fn partial_cmp(&self, other: &Self) -> Option<Ordering>

assert!(Frac::from_int(1) > Frac::from_int(0));
assert!(-Frac::from_exp10(-10) < Frac::from_exp10(-10));
assert_eq!(
    Frac::from_int(1).partial_cmp(&(
        Frac::from_int(2) * Frac::from_int(5) / Frac::from_int(10)
    )),
    Some(Ordering::Equal)
);

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 Real for Frac

fn from_int(i: isize) -> Self

fn from_f64(d: f64) -> Self

fn from_frac(frac: Self) -> Self

fn add_ref(self, rhs: &Self) -> Self

fn sub_ref(self, rhs: &Self) -> Self

fn mul_ref(self, rhs: &Self) -> Self

fn div_ref(self, rhs: &Self) -> Self

fn poweri(self, n: i16) -> Self

impl Sub<&Frac> for Frac

type Output = Frac

The resulting type after applying the - operator.

fn sub(self, rhs: &Self) -> Self

Performs the - operation.

impl Sub for Frac

type Output = Frac

The resulting type after applying the - operator.

fn sub(self, rhs: Self) -> Self

Performs the - operation.

impl SubAssign<&Frac> for Frac

fn sub_assign(&mut self, rhs: &Self)

Performs the -= operation.

impl SubAssign for Frac

fn sub_assign(&mut self, rhs: Self)

Performs the -= operation.

impl Copy for Frac

impl Eq for Frac

impl StructuralPartialEq for Frac