Struct bigdecimal::BigDecimal

pub struct BigDecimal { /* fields omitted */ }

A big decimal type.

Methods

impl BigDecimal

fn new(digits: BigInt, scale: i64) -> BigDecimal

Creates and initializes a BigDecimal.

fn parse_bytes(buf: &[u8], radix: u32) -> Option<BigDecimal>

Creates and initializes a BigDecimal.

Examples

// assert_eq!(BigDecimal::parse_bytes(b"0", 16), BigDecimal::zero());
// assert_eq!(BigDecimal::parse_bytes(b"f", 16), BigDecimal::parse_bytes(b"16", 10));

fn with_scale(&self, new_scale: i64) -> BigDecimal

Return a new BigDecimal object equivalent to self, with internal scaling set to the number specified. If the new_scale is lower than the current value, digits will be dropped.

fn sign(&self) -> Sign

Return the sign of the BigDecimal as num::bigint::Sign.

Examples

extern crate num;
extern crate bigdecimal;
use std::str::FromStr;

assert_eq!(bigdecimal::BigDecimal::from_str("-1").unwrap().sign(), num::bigint::Sign::Minus);
assert_eq!(bigdecimal::BigDecimal::from_str("0").unwrap().sign(), num::bigint::Sign::NoSign);
assert_eq!(bigdecimal::BigDecimal::from_str("1").unwrap().sign(), num::bigint::Sign::Plus);

Trait Implementations

impl Clone for BigDecimal

fn clone(&self) -> BigDecimal

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Debug for BigDecimal

fn fmt(&self, __arg_0: &mut Formatter) -> Result

Formats the value using the given formatter.

impl Hash for BigDecimal

fn hash<__H: Hasher>(&self, __arg_0: &mut __H)

Feeds this value into the given [Hasher].

fn hash_slice<H>(data: &[Self], state: &mut H) where
    H: Hasher, 

Feeds a slice of this type into the given [Hasher].

impl Eq for BigDecimal

impl FromStr for BigDecimal

type Err = ParseBigDecimalError

The associated error which can be returned from parsing.

fn from_str(s: &str) -> Result<BigDecimal, ParseBigDecimalError>

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

impl PartialOrd for BigDecimal

fn partial_cmp(&self, other: &BigDecimal) -> 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 Ord for BigDecimal

fn cmp(&self, other: &BigDecimal) -> Ordering

Complete ordering implementation for BigDecimal

Example

use std::str::FromStr;

let a = bigdecimal::BigDecimal::from_str("-1").unwrap();
let b = bigdecimal::BigDecimal::from_str("1").unwrap();
assert!(a < b);
assert!(b > a);
let c = bigdecimal::BigDecimal::from_str("1").unwrap();
assert!(b >= c);
assert!(c >= b);
let d = bigdecimal::BigDecimal::from_str("10.0").unwrap();
assert!(d > c);
let e = bigdecimal::BigDecimal::from_str(".5").unwrap();
assert!(e < c);

impl PartialEq for BigDecimal

fn eq(&self, rhs: &BigDecimal) -> 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 Default for BigDecimal

fn default() -> BigDecimal

Returns the "default value" for a type.

impl Zero for BigDecimal

fn zero() -> BigDecimal

Returns the additive identity element of Self, 0.

fn is_zero(&self) -> bool

Returns true if self is equal to the additive identity.

impl One for BigDecimal

fn one() -> BigDecimal

Returns the multiplicative identity element of Self, 1.

impl Add<BigDecimal> for BigDecimal

type Output = BigDecimal

The resulting type after applying the + operator

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

The method for the + operator

impl<'a> Add<&'a BigDecimal> for BigDecimal

type Output = BigDecimal

The resulting type after applying the + operator

fn add(self, other: &BigDecimal) -> BigDecimal

The method for the + operator

impl<'a> Add<BigDecimal> for &'a BigDecimal

type Output = BigDecimal

The resulting type after applying the + operator

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

The method for the + operator

impl<'a, 'b> Add<&'b BigDecimal> for &'a BigDecimal

type Output = BigDecimal

The resulting type after applying the + operator

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

The method for the + operator

impl AddAssign<BigDecimal> for BigDecimal

fn add_assign(&mut self, other: BigDecimal)

The method for the += operator

impl<'a> AddAssign<&'a BigDecimal> for BigDecimal

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

The method for the += operator

impl Sub<BigDecimal> for BigDecimal

type Output = BigDecimal

The resulting type after applying the - operator

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

The method for the - operator

impl<'a> Sub<&'a BigDecimal> for BigDecimal

type Output = BigDecimal

The resulting type after applying the - operator

fn sub(self, other: &BigDecimal) -> BigDecimal

The method for the - operator

impl<'a> Sub<BigDecimal> for &'a BigDecimal

type Output = BigDecimal

The resulting type after applying the - operator

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

The method for the - operator

impl<'a, 'b> Sub<&'b BigDecimal> for &'a BigDecimal

type Output = BigDecimal

The resulting type after applying the - operator

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

The method for the - operator

impl SubAssign<BigDecimal> for BigDecimal

fn sub_assign(&mut self, other: BigDecimal)

The method for the -= operator

impl<'a> SubAssign<&'a BigDecimal> for BigDecimal

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

The method for the -= operator

impl Mul<BigDecimal> for BigDecimal

type Output = BigDecimal

The resulting type after applying the * operator

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

The method for the * operator

impl<'a> Mul<&'a BigDecimal> for BigDecimal

type Output = BigDecimal

The resulting type after applying the * operator

fn mul(self, other: &BigDecimal) -> BigDecimal

The method for the * operator

impl<'a> Mul<BigDecimal> for &'a BigDecimal

type Output = BigDecimal

The resulting type after applying the * operator

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

The method for the * operator

impl<'a, 'b> Mul<&'b BigDecimal> for &'a BigDecimal

type Output = BigDecimal

The resulting type after applying the * operator

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

The method for the * operator

impl MulAssign<BigDecimal> for BigDecimal

fn mul_assign(&mut self, other: BigDecimal)

The method for the *= operator

impl<'a> MulAssign<&'a BigDecimal> for BigDecimal

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

The method for the *= operator

impl Div<BigDecimal> for BigDecimal

type Output = BigDecimal

The resulting type after applying the / operator

fn div(self, other: BigDecimal) -> BigDecimal

The method for the / operator

impl<'a> Div<&'a BigDecimal> for BigDecimal

type Output = BigDecimal

The resulting type after applying the / operator

fn div(self, other: &BigDecimal) -> BigDecimal

The method for the / operator

impl<'a> Div<BigDecimal> for &'a BigDecimal

type Output = BigDecimal

The resulting type after applying the / operator

fn div(self, other: BigDecimal) -> BigDecimal

The method for the / operator

impl<'a, 'b> Div<&'b BigDecimal> for &'a BigDecimal

type Output = BigDecimal

The resulting type after applying the / operator

fn div(self, other: &BigDecimal) -> BigDecimal

The method for the / operator

impl Rem<BigDecimal> for BigDecimal

type Output = BigDecimal

The resulting type after applying the % operator

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

The method for the % operator

impl<'a> Rem<&'a BigDecimal> for BigDecimal

type Output = BigDecimal

The resulting type after applying the % operator

fn rem(self, other: &BigDecimal) -> BigDecimal

The method for the % operator

impl<'a> Rem<BigDecimal> for &'a BigDecimal

type Output = BigDecimal

The resulting type after applying the % operator

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

The method for the % operator

impl<'a, 'b> Rem<&'b BigDecimal> for &'a BigDecimal

type Output = BigDecimal

The resulting type after applying the % operator

fn rem(self, _: &BigDecimal) -> BigDecimal

The method for the % operator

impl Neg for BigDecimal

type Output = BigDecimal

The resulting type after applying the - operator

fn neg(self) -> BigDecimal

The method for the unary - operator

impl<'a> Neg for &'a BigDecimal

type Output = BigDecimal

The resulting type after applying the - operator

fn neg(self) -> BigDecimal

The method for the unary - operator

impl Signed for BigDecimal

fn abs(&self) -> BigDecimal

Computes the absolute value.

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

The positive difference of two numbers.

fn signum(&self) -> BigDecimal

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 Display for BigDecimal

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

Formats the value using the given formatter.

impl Num for BigDecimal

type FromStrRadixErr = ParseBigDecimalError

fn from_str_radix(
    s: &str,
    radix: u32
) -> Result<BigDecimal, ParseBigDecimalError>

Creates and initializes a BigDecimal.

impl ToPrimitive for BigDecimal

fn to_i64(&self) -> Option<i64>

Converts the value of self to an i64.

fn to_u64(&self) -> Option<u64>

Converts the value of self to an u64.

fn to_f64(&self) -> Option<f64>

Converts the value of self to an f64.

fn to_isize(&self) -> Option<isize>

Converts the value of self to an isize.

fn to_i8(&self) -> Option<i8>

Converts the value of self to an i8.

fn to_i16(&self) -> Option<i16>

Converts the value of self to an i16.

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

Converts the value of self to an i32.

fn to_usize(&self) -> Option<usize>

Converts the value of self to a usize.

fn to_u8(&self) -> Option<u8>

Converts the value of self to an u8.

fn to_u16(&self) -> Option<u16>

Converts the value of self to an u16.

fn to_u32(&self) -> Option<u32>

Converts the value of self to an u32.

fn to_f32(&self) -> Option<f32>

Converts the value of self to an f32.

impl ToBigInt for BigDecimal

fn to_bigint(&self) -> Option<BigInt>

Converts the value of self to a BigInt.