Struct floating_bar::r32

pub struct r32(_);

The 32-bit floating bar type.

Implementations

impl r32

pub const unsafe fn new_unchecked(numer: i32, denom: u32) -> r32

Creates a rational number without checking the values.

Safety

The values must fit in the fraction field.

pub fn new(numer: i32, denom: u32) -> Option<r32>

Creates a rational number if the given values both fit in the fraction field.

pub fn sqrt(self) -> r32

Calculates the approximate square root of the value.

Warning: This method can give a number that overflows easily, so use it with caution, and discard it as soon as you’re done with it.

pub fn cbrt(self) -> r32

Calculates the approximate cube root of the value.

Warning: This method can give a number that overflows easily, so use it with caution, and discard it as soon as you’re done with it.

pub fn checked_add(self, rhs: r32) -> Option<r32>

Checked addition. Computes self + rhs, returning None if overflow occurred.

pub fn checked_mul(self, rhs: r32) -> Option<r32>

Checked multiplication. Computes self * rhs, returning None if overflow occurred.

If one argument is NaN and the other is zero, this returns zero.

pub fn to_i32(self) -> Option<i32>

Checked conversion to i32.

Returns the numeric value as an i32 if its irreducible form has a denominator of 1. Otherwise, returns None.

impl r32

pub const MAX: r32

The highest value that can be represented by this rational type.

pub const MIN: r32

The lowest value that can be represented by this rational type.

pub const MIN_POSITIVE: r32

The smallest positive value that can be represented by this rational type.

pub const NAN: r32

Not a Number (NaN).

pub fn is_nan(self) -> bool

Returns true if this value is NAN and false otherwise.

pub fn is_positive(self) -> bool

Returns true if self is positive and false if the number is zero, negative, or NAN.

pub fn is_negative(self) -> bool

Returns true if self is negative and false if the number is zero, positive, or NAN.

pub fn trunc(self) -> r32

Returns the integer part of a number, or NaN if self is NaN.

pub fn fract(self) -> r32

Returns the fractional part of a number, or NaN if self is NaN.

pub fn floor(self) -> r32

Returns the largest integer less than or equal to a number.

pub fn ceil(self) -> r32

Returns the smallest integer greater than or equal to a number.

pub fn round(self) -> r32

Returns the nearest integer to a number. Round half-way cases away from zero.

pub fn abs(self) -> r32

Computes the absolute value of self.

pub fn signum(self) -> r32

Returns a number that represents the sign of self.

• 1 if the number is positive
• -1 if the number is negative
• 0 if the number is 0
• NAN if the number is NAN.

pub fn recip(self) -> r32

Takes the reciprocal (inverse) of a number, 1/x.

Panics

Panics when the numerator is zero.

pub fn normalize(self) -> r32

Cancels out common factors between the numerator and the denominator.

pub fn pow(self, exp: i32) -> r32

Checked exponentiation. Computes self.pow(exp), returning None if overflow occurred.

pub fn max(self, other: r32) -> r32

Returns the maximum of the two numbers.

If one of the arguments is NaN, then the other argument is returned.

pub fn min(self, other: r32) -> r32

Returns the minimum of the two numbers.

If one of the arguments is NaN, then the other argument is returned.

pub fn checked_neg(self) -> Option<r32>

Checked rational negation. Computes -self, returning None if the numerator would overflow.

pub fn checked_abs(self) -> Option<r32>

Checked absolute value. Computes self.abs(), returning None if the numerator would overflow.

pub fn checked_recip(self) -> Option<r32>

Checked reciprocal. Computes 1/self, returning None if the numerator is zero.

pub fn checked_pow(self, exp: i32) -> Option<r32>

Checked exponentiation. Computes self.pow(exp), returning None if overflow occurred.

pub fn checked_sub(self, rhs: r32) -> Option<r32>

Checked subtraction. Computes self - rhs, returning None if overflow occurred.

pub fn checked_div(self, rhs: r32) -> Option<r32>

Checked rational division. Computes self / rhs, returning None if rhs == 0 or the division results in overflow.

pub fn checked_rem(self, rhs: r32) -> Option<r32>

Checked rational remainder. Computes self % rhs, returning None if rhs == 0 or the division results in overflow.

pub fn to_bits(self) -> u32

Raw transmutation to u64.

Useful if you need access to the payload bits of a NaN value.

pub fn from_bits(bits: u32) -> r32

Raw transmutation from u64.

Trait Implementations

impl Add<r32> for r32

type Output = r32

The resulting type after applying the + operator.

fn add(self, other: r32) -> Self::Output

Performs the + operation.

impl AddAssign<r32> for r32

fn add_assign(&mut self, other: r32)

Performs the += operation.

impl Clone for r32

fn clone(&self) -> r32

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Copy for r32

impl Debug for r32

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

Formats the value using the given formatter.

impl Default for r32

fn default() -> r32

Returns the “default value” for a type.

impl Display for r32

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

Formats the value using the given formatter.

impl Div<r32> for r32

type Output = r32

The resulting type after applying the / operator.

fn div(self, other: r32) -> Self::Output

Performs the / operation.

impl DivAssign<r32> for r32

fn div_assign(&mut self, other: r32)

Performs the /= operation.

impl Eq for r32

impl From<f32> for r32

fn from(f: f32) -> Self

Performs the conversion.

impl From<i16> for r32

fn from(v: i16) -> Self

Performs the conversion.

impl From<i8> for r32

fn from(v: i8) -> Self

Performs the conversion.

impl From<r32> for r64

fn from(v: r32) -> Self

Performs the conversion.

impl From<u16> for r32

fn from(v: u16) -> Self

Performs the conversion.

impl From<u8> for r32

fn from(v: u8) -> Self

Performs the conversion.

impl FromStr for r32

type Err = ParseRatioErr

The associated error which can be returned from parsing.

fn from_str(src: &str) -> Result<Self, Self::Err>

Converts a string in base 10 to a rational.

This function accepts strings such as

• ‘157/50’
• ‘-157/50’
• ‘25’, or equivalently, ‘25/1’
• ‘NaN’

Leading and trailing whitespace represent an error.

Return value

Err(ParseRatioError) if the string did not contain a valid rational number. Otherwise, Ok(n) where n is the floating-bar number represented by src.

impl Mul<r32> for r32

type Output = r32

The resulting type after applying the * operator.

fn mul(self, other: r32) -> Self::Output

Performs the * operation.

impl MulAssign<r32> for r32

fn mul_assign(&mut self, other: r32)

Performs the *= operation.

impl Neg for r32

type Output = r32

The resulting type after applying the - operator.

fn neg(self) -> Self::Output

Performs the unary - operation.

impl PartialEq<r32> for r32

fn eq(&self, other: &r32) -> bool

This method tests for self and other values to be equal, and is used by ==.

#[must_use]pub fn ne(&self, other: &Rhs) -> bool

This method tests for !=.

impl PartialOrd<r32> for r32

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

This method returns an ordering between self and other values if one exists.

#[must_use]pub fn lt(&self, other: &Rhs) -> bool

This method tests less than (for self and other) and is used by the < operator.

#[must_use]pub fn le(&self, other: &Rhs) -> bool

This method tests less than or equal to (for self and other) and is used by the <= operator.

#[must_use]pub fn gt(&self, other: &Rhs) -> bool

This method tests greater than (for self and other) and is used by the > operator.

#[must_use]pub 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 Rem<r32> for r32

type Output = r32

The resulting type after applying the % operator.

fn rem(self, other: r32) -> Self::Output

Performs the % operation.

impl RemAssign<r32> for r32

fn rem_assign(&mut self, other: r32)

Performs the %= operation.

impl StructuralEq for r32

impl Sub<r32> for r32

type Output = r32

The resulting type after applying the - operator.

fn sub(self, other: r32) -> Self::Output

Performs the - operation.

impl SubAssign<r32> for r32

fn sub_assign(&mut self, other: r32)

Performs the -= operation.