Struct Decimal

pub struct Decimal<T: Copy + Integer> { /* private fields */ }

Implementations

impl<T: Copy + Integer + FromPrimitive + ToPrimitive> Decimal<T>

pub fn from_parts(mantissa: T, exponent: Exp) -> Decimal<T>

Create Decimal from mantissa and exponent.

pub fn round(&self) -> Decimal<T>

Rounds to nearest integer. Half-way cases are rounded away from zero. Doesn’t alter precision.

pub fn to_f64(&self) -> f64

Convert to f64, possibly with precision loss and overflows. Currently conversion isn’t perfect, i. e. it may be inexact even when exact conversion is possible.

pub fn to_f32(&self) -> f32

Convert to f32, possibly with precision loss and overflows. Currently conversion isn’t perfect, i. e. it may be inexact even when exact conversion is possible.

pub fn to_int<U: Clone + Integer + FromPrimitive + From<T>>(&self) -> U

Convert to an integer, truncating fractional part. May overflow.

pub fn to_parts(&self) -> (T, Exp)

Returns significand and exponent.

pub fn canonical(&self) -> Decimal<T>

pub fn int_div(&self, other: Decimal<T>) -> T

Returns result of division, rounded to integer. It’s same as (*this / other).to_int() but is less likely to overflow internally.

Trait Implementations

impl<T> Add for Decimal<T>

where T: Copy + Integer + FromPrimitive + ToPrimitive,

type Output = Decimal<T>

The resulting type after applying the + operator.

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

Performs the + operation.

impl<T> AddAssign for Decimal<T>

where T: Copy + Integer + FromPrimitive + ToPrimitive,

fn add_assign(&mut self, other: Self)

Performs the += operation.

impl<T: Clone + Copy + Integer> Clone for Decimal<T>

fn clone(&self) -> Decimal<T>

Returns a copy of the value.

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

Performs copy-assignment from source.

impl<T: Debug + Copy + Integer> Debug for Decimal<T>

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

Formats the value using the given formatter.

impl<'de, T> Deserialize<'de> for Decimal<T>

where T: Copy + Integer + Signed + FromPrimitive + ToPrimitive + FromStr + Display,

fn deserialize<D>(deserializer: D) -> Result<Decimal<T>, D::Error>

where D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl<T> Display for Decimal<T>

where T: Copy + Integer + FromPrimitive + ToPrimitive + Display,

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

Formats the value using the given formatter.

impl<T> Div for Decimal<T>

where T: Copy + Integer + FromPrimitive + ToPrimitive,

type Output = Decimal<T>

The resulting type after applying the / operator.

fn div(self, other: Self) -> Decimal<T>

Performs the / operation.

impl<U, T> From<U> for Decimal<T>

where U: Integer, T: Copy + Integer + FromPrimitive + ToPrimitive + From<U>,

fn from(u: U) -> Self

Converts to this type from the input type.

impl<T> FromStr for Decimal<T>

where T: Copy + Integer + Signed + FromPrimitive + ToPrimitive + FromStr,

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

TODO: better validation and proper error handling. Now all valid inputs can be parsed, but some invalid also pass.

type Err = ParseDecimalError

The associated error which can be returned from parsing.

impl<T> Mul for Decimal<T>

where T: Copy + Integer + FromPrimitive + ToPrimitive,

type Output = Decimal<T>

The resulting type after applying the * operator.

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

Performs the * operation.

impl<T> Neg for Decimal<T>

where T: Copy + Integer + Signed + FromPrimitive + ToPrimitive,

type Output = Decimal<T>

The resulting type after applying the - operator.

fn neg(self) -> Self

Performs the unary - operation.

impl<T> Num for Decimal<T>

where T: Copy + Integer + Signed + FromPrimitive + ToPrimitive + FromStr,

type FromStrRadixErr = DecimalFromStrRadixErr

fn from_str_radix(s: &str, radix: u32) -> Result<Self, Self::FromStrRadixErr>

Convert from a string and radix (typically 2..=36).

impl<T> One for Decimal<T>

where T: Copy + Integer + One + FromPrimitive + ToPrimitive,

fn one() -> Self

Returns the multiplicative identity element of Self, 1.

fn set_one(&mut self)

Sets self to the multiplicative identity element of Self, 1.

fn is_one(&self) -> bool

where Self: PartialEq,

Returns true if self is equal to the multiplicative identity.

impl<T> Ord for Decimal<T>

where T: Copy + Integer + FromPrimitive + ToPrimitive,

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

where T: Copy + Integer + FromPrimitive + ToPrimitive,

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<T> PartialOrd for Decimal<T>

where T: Copy + Integer + FromPrimitive + ToPrimitive,

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<T> Rem for Decimal<T>

where T: Copy + Integer + FromPrimitive + ToPrimitive,

type Output = Decimal<T>

The resulting type after applying the % operator.

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

Performs the % operation.

impl<T> Serialize for Decimal<T>

where T: Copy + Integer + Signed + FromPrimitive + ToPrimitive + FromStr + Display,

fn serialize<S>(&self, serializer: S) -> Result<S::Ok, S::Error>

where S: Serializer,

Serialize this value into the given Serde serializer.

impl<T> Signed for Decimal<T>

where T: Copy + Integer + Signed + FromPrimitive + ToPrimitive + FromStr,

fn abs(&self) -> Self

Computes the absolute value.

fn abs_sub(&self, other: &Self) -> Self

The positive difference of two numbers.

fn signum(&self) -> Self

Returns the sign of the number.

fn is_positive(&self) -> bool

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

fn is_negative(&self) -> bool

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

impl<T> Sub for Decimal<T>

where T: Copy + Integer + FromPrimitive + ToPrimitive,

type Output = Decimal<T>

The resulting type after applying the - operator.

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

Performs the - operation.

impl<T> Zero for Decimal<T>

where T: Copy + Integer + FromPrimitive + ToPrimitive,

fn zero() -> Self

Returns the additive identity element of Self, 0.

fn is_zero(&self) -> bool

Returns true if self is equal to the additive identity.

fn set_zero(&mut self)

Sets self to the additive identity element of Self, 0.

impl<T: Copy + Copy + Integer> Copy for Decimal<T>

impl<T> Eq for Decimal<T>

where T: Copy + Integer + FromPrimitive + ToPrimitive,