Struct MpFloat 

pub struct MpFloat { /* private fields */ }

Arbitrary-precision floating-point number.

Wraps DBig with a precision (in binary bits) stored alongside so that prec() returns the correct bit width. All arithmetic is carried out at the stored precision.

Implementations

impl MpFloat

pub fn with_val(bits: u32, v: f64) -> Self

Create a new MpFloat from an f64 at the given bit precision.

Examples

use oxinum_float::mp_float::MpFloat;
let x = MpFloat::with_val(256, 3.14f64);
assert!((x.to_f64() - 3.14).abs() < 1e-10);

pub fn with_val_from(bits: u32, other: &MpFloat) -> Self

Create a new MpFloat from another MpFloat value at the given bit precision (analogous to rug::Float::with_val(bits, &other)).

pub fn from_dbig(d: &DBig, bits: u32) -> Self

Create from a DBig reference, using the existing precision.

pub fn prec(&self) -> u32

Return the precision in binary bits.

pub fn decimal_prec(&self) -> usize

Return the decimal precision used internally.

pub fn to_f64(&self) -> f64

Convert to f64 (may lose precision).

pub fn as_dbig(&self) -> &DBig

Borrow the inner DBig.

pub fn is_zero(&self) -> bool

True if the value is exactly zero.

pub fn is_finite(&self) -> bool

True if the value is finite (always true for DBig).

pub fn is_integer(&self) -> bool

True if the value is an integer (fractional part is zero).

pub fn is_sign_positive(&self) -> bool

True if the value is strictly positive.

pub fn is_sign_negative(&self) -> bool

True if the value is strictly negative.

pub fn abs(self) -> Self

Absolute value.

pub fn sqrt(self) -> Self

Square root. Returns 0 for negative inputs (mirrors MPFR NaN→0 fallback).

pub fn exp(self) -> Self

Exponential e^x.

pub fn ln(self) -> Self

Natural logarithm. Returns 0 for x ≤ 0 (fallback).

pub fn sin(self) -> Self

Sine.

pub fn cos(self) -> Self

Cosine.

pub fn gamma(self) -> Self

Gamma function Γ(self).

pub fn gamma_mut(&mut self)

Apply gamma function in-place (mirrors rug::Float::gamma_mut()).

pub fn ln_gamma(self) -> Self

Log-gamma function ln(Γ(self)).

pub fn ln_gamma_mut(&mut self)

Apply log-gamma in-place (mirrors rug::Float::ln_gamma_mut()).

pub fn digamma(self) -> Self

Digamma function ψ(self).

pub fn digamma_mut(&mut self)

Apply digamma in-place (mirrors rug::Float::digamma_mut()).

pub fn erf(self) -> Self

Error function erf(self).

pub fn erf_mut(&mut self)

Apply erf in-place (mirrors rug::Float::erf_mut()).

pub fn erfc(self) -> Self

Complementary error function erfc(self).

pub fn erfc_mut(&mut self)

Apply erfc in-place (mirrors rug::Float::erfc_mut()).

pub fn j0(self) -> Self

Bessel function J₀(self).

pub fn j0_mut(&mut self)

Apply j0 in-place (mirrors rug::Float::j0_mut()).

pub fn pow_float(self, exp: &MpFloat) -> Self

Raise to the power of another MpFloat.

pub fn pow_i32(self, exp: i32) -> Self

Raise to an integer power.

pub fn pow_f64(self, exp: f64) -> Self

Raise to an f64 power (convenience).

Trait Implementations

impl Add for MpFloat

type Output = MpFloat

The resulting type after applying the + operator.

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

Performs the + operation.

impl Add<&MpFloat> for &MpFloat

type Output = MpFloat

The resulting type after applying the + operator.

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

Performs the + operation.

impl Add<&MpFloat> for MpFloat

type Output = MpFloat

The resulting type after applying the + operator.

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

Performs the + operation.

impl Add<f64> for &MpFloat

type Output = MpFloat

The resulting type after applying the + operator.

fn add(self, rhs: f64) -> MpFloat

Performs the + operation.

impl Add<f64> for MpFloat

type Output = MpFloat

The resulting type after applying the + operator.

fn add(self, rhs: f64) -> MpFloat

Performs the + operation.

impl AddAssign for MpFloat

fn add_assign(&mut self, rhs: MpFloat)

Performs the += operation.

impl AddAssign<&MpFloat> for MpFloat

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

Performs the += operation.

impl AddAssign<f64> for MpFloat

fn add_assign(&mut self, rhs: f64)

Performs the += operation.

impl Clone for MpFloat

fn clone(&self) -> MpFloat

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for MpFloat

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

Formats the value using the given formatter.

impl Display for MpFloat

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

Formats the value using the given formatter.

impl Div for MpFloat

type Output = MpFloat

The resulting type after applying the / operator.

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

Performs the / operation.

impl Div<&MpFloat> for &MpFloat

type Output = MpFloat

The resulting type after applying the / operator.

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

Performs the / operation.

impl Div<&MpFloat> for MpFloat

type Output = MpFloat

The resulting type after applying the / operator.

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

Performs the / operation.

impl Div<f64> for &MpFloat

type Output = MpFloat

The resulting type after applying the / operator.

fn div(self, rhs: f64) -> MpFloat

Performs the / operation.

impl Div<f64> for MpFloat

type Output = MpFloat

The resulting type after applying the / operator.

fn div(self, rhs: f64) -> MpFloat

Performs the / operation.

impl DivAssign for MpFloat

fn div_assign(&mut self, rhs: MpFloat)

Performs the /= operation.

impl DivAssign<&MpFloat> for MpFloat

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

Performs the /= operation.

impl DivAssign<f64> for MpFloat

fn div_assign(&mut self, rhs: f64)

Performs the /= operation.

impl LowerExp for MpFloat

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

Formats the value using the given formatter.

impl MpPow<&MpFloat> for MpFloat

fn pow(self, exp: &MpFloat) -> MpFloat

impl MpPow<MpFloat> for MpFloat

fn pow(self, exp: MpFloat) -> MpFloat

impl MpPow<f64> for MpFloat

fn pow(self, exp: f64) -> MpFloat

impl MpPow<i32> for MpFloat

fn pow(self, exp: i32) -> MpFloat

impl Mul for MpFloat

type Output = MpFloat

The resulting type after applying the * operator.

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

Performs the * operation.

impl Mul<&MpFloat> for &MpFloat

type Output = MpFloat

The resulting type after applying the * operator.

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

Performs the * operation.

impl Mul<&MpFloat> for MpFloat

type Output = MpFloat

The resulting type after applying the * operator.

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

Performs the * operation.

impl Mul<f64> for &MpFloat

type Output = MpFloat

The resulting type after applying the * operator.

fn mul(self, rhs: f64) -> MpFloat

Performs the * operation.

impl Mul<f64> for MpFloat

type Output = MpFloat

The resulting type after applying the * operator.

fn mul(self, rhs: f64) -> MpFloat

Performs the * operation.

impl MulAssign for MpFloat

fn mul_assign(&mut self, rhs: MpFloat)

Performs the *= operation.

impl MulAssign<&MpFloat> for MpFloat

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

Performs the *= operation.

impl MulAssign<f64> for MpFloat

fn mul_assign(&mut self, rhs: f64)

Performs the *= operation.

impl Neg for &MpFloat

type Output = MpFloat

The resulting type after applying the - operator.

fn neg(self) -> MpFloat

Performs the unary - operation.

impl Neg for MpFloat

type Output = MpFloat

The resulting type after applying the - operator.

fn neg(self) -> MpFloat

Performs the unary - operation.

impl PartialEq for MpFloat

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

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

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 PartialOrd<f64> for MpFloat

fn partial_cmp(&self, other: &f64) -> 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 Sub for MpFloat

type Output = MpFloat

The resulting type after applying the - operator.

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

Performs the - operation.

impl Sub<&MpFloat> for &MpFloat

type Output = MpFloat

The resulting type after applying the - operator.

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

Performs the - operation.

impl Sub<&MpFloat> for MpFloat

type Output = MpFloat

The resulting type after applying the - operator.

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

Performs the - operation.

impl Sub<f64> for &MpFloat

type Output = MpFloat

The resulting type after applying the - operator.

fn sub(self, rhs: f64) -> MpFloat

Performs the - operation.

impl Sub<f64> for MpFloat

type Output = MpFloat

The resulting type after applying the - operator.

fn sub(self, rhs: f64) -> MpFloat

Performs the - operation.

impl SubAssign for MpFloat

fn sub_assign(&mut self, rhs: MpFloat)

Performs the -= operation.

impl SubAssign<&MpFloat> for MpFloat

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

Performs the -= operation.

impl SubAssign<f64> for MpFloat

fn sub_assign(&mut self, rhs: f64)

Performs the -= operation.

impl UpperExp for MpFloat

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

Formats the value using the given formatter.