Struct rustduino::math::F32

pub struct F32(pub f32);

32-bit floating point wrapper which implements fast approximation-based operations.

Implementations

impl F32

pub fn abs(self) -> F32

Computes the absolute value of self.

Returns Self::NAN if the number is Self::NAN.

impl F32

pub fn asin(self) -> F32

Computes asin(x) approximation in radians in the range [-pi/2, pi/2].

impl F32

pub fn atan(self) -> F32

Approximates atan(x) approximation in radians with a maximum error of 0.002.

Returns Self::NAN if the number is Self::NAN.

pub fn atan_norm(self) -> F32

Approximates atan(x) normalized to the [−1,1] range with a maximum error of 0.1620 degrees.

impl F32

pub fn atan2(self, rhs: F32) -> F32

Approximates the four quadrant arctangent of self (y) and rhs (x) in radians with a maximum error of 0.002.

• x = 0, y = 0: 0
• x >= 0: arctan(y/x) -> [-pi/2, pi/2]
• y >= 0: arctan(y/x) + pi -> (pi/2, pi]
• y < 0: arctan(y/x) - pi -> (-pi, -pi/2)

impl F32

pub fn ceil(self) -> F32

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

impl F32

pub fn copysign(self, sign: F32) -> F32

Returns a number composed of the magnitude of self and the sign of sign.

impl F32

pub fn cos(self) -> F32

Approximates cos(x) in radians with a maximum error of 0.002.

impl F32

pub fn div_euclid(self, rhs: F32) -> F32

Calculates Euclidean division, the matching method for rem_euclid.

impl F32

pub fn exp(self) -> F32

Returns e^(self), (the exponential function).

impl F32

pub fn floor(self) -> F32

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

impl F32

pub fn fract(self) -> F32

Returns the fractional part of a number with sign.

impl F32

pub fn hypot(self, rhs: F32) -> F32

Calculate the length of the hypotenuse of a right-angle triangle.

impl F32

pub fn inv(self) -> F32

Fast approximation of 1/x.

impl F32

pub fn invsqrt(self) -> F32

Approximate inverse square root with an average deviation of ~5%.

impl F32

pub fn ln(self) -> F32

Approximates the natural logarithm of the number.

impl F32

pub fn log(self, base: F32) -> F32

Approximates the logarithm of the number with respect to an arbitrary base.

impl F32

pub fn log10(self) -> F32

Approximates the base 10 logarithm of the number.

impl F32

pub fn log2(self) -> F32

Approximates the base 2 logarithm of the number.

impl F32

pub fn powf(self, n: F32) -> F32

Approximates a number raised to a floating point power.

impl F32

pub fn powi(self, n: i32) -> F32

Approximates a number raised to an integer power.

impl F32

pub fn rem_euclid(self, rhs: F32) -> F32

Calculates the least non-negative remainder of self (mod rhs).

impl F32

pub fn round(self) -> F32

Returns the nearest integer to a number.

impl F32

pub fn sin(self) -> F32

Approximates sin(x) in radians with a maximum error of 0.002.

impl F32

pub fn sqrt(self) -> F32

Approximates the square root of a number with an average deviation of ~5%.

Returns Self::NAN if self is a negative number.

impl F32

pub fn tan(self) -> F32

Approximates tan(x) in radians with a maximum error of 0.6.

impl F32

pub fn trunc(self) -> F32

Returns the integer part of a number.

impl F32

pub const ZERO: F32

The value 0.0.

pub const ONE: F32

The value 1.0.

pub const RADIX: u32

The radix or base of the internal representation of f32.

pub const MANTISSA_DIGITS: u32

Number of significant digits in base 2.

pub const DIGITS: u32

Approximate number of significant digits in base 10.

pub const EPSILON: F32

Machine epsilon value for f32.

This is the difference between 1.0 and the next larger representable number.

pub const MIN: F32

Smallest finite f32 value.

pub const MIN_POSITIVE: F32

Smallest positive normal f32 value.

pub const MAX: F32

Largest finite f32 value.

pub const MIN_EXP: i32

One greater than the minimum possible normal power of 2 exponent.

pub const MAX_EXP: i32

Maximum possible power of 2 exponent.

pub const MIN_10_EXP: i32

Minimum possible normal power of 10 exponent.

pub const MAX_10_EXP: i32

Maximum possible power of 10 exponent.

pub const NAN: F32

Not a Number (NaN).

pub const INFINITY: F32

Infinity (∞).

pub const NEG_INFINITY: F32

Negative infinity (−∞).

pub fn is_nan(self) -> bool

Returns true if this value is NaN.

pub fn is_infinite(self) -> bool

Returns true if this value is positive infinity or negative infinity, and false otherwise.

pub fn is_finite(self) -> bool

Returns true if this number is neither infinite nor NaN.

pub fn is_sign_positive(self) -> bool

Returns true if self has a positive sign, including +0.0, NaNs with positive sign bit and positive infinity.

pub fn is_sign_negative(self) -> bool

Returns true if self has a negative sign, including -0.0, NaNs with negative sign bit and negative infinity.

pub fn to_bits(self) -> u32

Raw transmutation to u32.

This is currently identical to transmute::<f32, u32>(self) on all platforms.

See F32::from_bits for some discussion of the portability of this operation (there are almost no issues).

pub fn from_bits(v: u32) -> F32

Raw transmutation from u32.

This is currently identical to transmute::<u32, f32>(v) on all platforms. It turns out this is incredibly portable, for two reasons:

• Floats and Ints have the same endianness on all supported platforms.
• IEEE-754 very precisely specifies the bit layout of floats.

See f32::from_bits for more information.

Trait Implementations

impl Add<F32> for F32

type Output = F32

The resulting type after applying the + operator.

pub fn add(self, rhs: F32) -> F32

Performs the + operation.

impl Add<f32> for F32

type Output = F32

The resulting type after applying the + operator.

pub fn add(self, rhs: f32) -> F32

Performs the + operation.

impl AddAssign<F32> for F32

pub fn add_assign(&mut self, rhs: F32)

Performs the += operation.

impl AddAssign<f32> for F32

pub fn add_assign(&mut self, rhs: f32)

Performs the += operation.

impl Clone for F32

pub fn clone(&self) -> F32

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Debug for F32

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

Formats the value using the given formatter.

impl Default for F32

pub fn default() -> F32

Returns the “default value” for a type.

impl Display for F32

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

Formats the value using the given formatter.

impl Div<F32> for F32

type Output = F32

The resulting type after applying the / operator.

pub fn div(self, rhs: F32) -> F32

Performs the / operation.

impl Div<f32> for F32

type Output = F32

The resulting type after applying the / operator.

pub fn div(self, rhs: f32) -> F32

Performs the / operation.

impl DivAssign<F32> for F32

pub fn div_assign(&mut self, rhs: F32)

Performs the /= operation.

impl DivAssign<f32> for F32

pub fn div_assign(&mut self, rhs: f32)

Performs the /= operation.

impl From<f32> for F32

pub fn from(n: f32) -> F32

Performs the conversion.

impl From<i16> for F32

pub fn from(n: i16) -> F32

Performs the conversion.

impl From<i8> for F32

pub fn from(n: i8) -> F32

Performs the conversion.

impl From<u16> for F32

pub fn from(n: u16) -> F32

Performs the conversion.

impl From<u8> for F32

pub fn from(n: u8) -> F32

Performs the conversion.

impl FromStr for F32

type Err = ParseFloatError

The associated error which can be returned from parsing.

pub fn from_str(src: &str) -> Result<F32, ParseFloatError>

Parses a string s to return a value of this type.

impl LowerExp for F32

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

Formats the value using the given formatter.

impl Mul<F32> for F32

type Output = F32

The resulting type after applying the * operator.

pub fn mul(self, rhs: F32) -> F32

Performs the * operation.

impl Mul<f32> for F32

type Output = F32

The resulting type after applying the * operator.

pub fn mul(self, rhs: f32) -> F32

Performs the * operation.

impl MulAssign<F32> for F32

pub fn mul_assign(&mut self, rhs: F32)

Performs the *= operation.

impl MulAssign<f32> for F32

pub fn mul_assign(&mut self, rhs: f32)

Performs the *= operation.

impl Neg for F32

type Output = F32

The resulting type after applying the - operator.

pub fn neg(self) -> F32

Performs the unary - operation.

impl PartialEq<F32> for F32

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

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

pub fn ne(&self, other: &F32) -> bool

This method tests for !=.

impl PartialEq<f32> for F32

pub fn eq(&self, other: &f32) -> 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 !=.

impl PartialOrd<F32> for F32

pub fn partial_cmp(&self, other: &F32) -> 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 PartialOrd<f32> for F32

pub fn partial_cmp(&self, other: &f32) -> 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 Product<F32> for F32

pub fn product<I>(iter: I) -> F32 where
    I: Iterator<Item = F32>, 

Method which takes an iterator and generates Self from the elements by multiplying the items.

impl Rem<F32> for F32

type Output = F32

The resulting type after applying the % operator.

pub fn rem(self, rhs: F32) -> F32

Performs the % operation.

impl Rem<f32> for F32

type Output = F32

The resulting type after applying the % operator.

pub fn rem(self, rhs: f32) -> F32

Performs the % operation.

impl RemAssign<F32> for F32

pub fn rem_assign(&mut self, rhs: F32)

Performs the %= operation.

impl RemAssign<f32> for F32

pub fn rem_assign(&mut self, rhs: f32)

Performs the %= operation.

impl Sub<F32> for F32

type Output = F32

The resulting type after applying the - operator.

pub fn sub(self, rhs: F32) -> F32

Performs the - operation.

impl Sub<f32> for F32

type Output = F32

The resulting type after applying the - operator.

pub fn sub(self, rhs: f32) -> F32

Performs the - operation.

impl SubAssign<F32> for F32

pub fn sub_assign(&mut self, rhs: F32)

Performs the -= operation.

impl SubAssign<f32> for F32

pub fn sub_assign(&mut self, rhs: f32)

Performs the -= operation.

impl Sum<F32> for F32

pub fn sum<I>(iter: I) -> F32 where
    I: Iterator<Item = F32>, 

Method which takes an iterator and generates Self from the elements by “summing up” the items.

impl UpperExp for F32

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

Formats the value using the given formatter.

impl Copy for F32

impl StructuralPartialEq for F32