Stdlib/std.decimal/Decimal

Decimal

struct Decimal

Methods

pub fn round(self, dp: int = 0): Decimal

Returns a new Decimal number with the specified number of decimal points for fractional portion. Rounding currently follows “Bankers Rounding” rules. e.g. 6.5 -> 6, 7.5 -> 8

pub fn min(self, b: Decimal): Decimal

Returns the minimum of the two numbers.

pub fn max(self, b: Decimal): Decimal

Returns the maximum of the two numbers.

pub fn is_zero(self): bool

Returns true if the decimal number is equivalent to zero.

pub fn is_sign_positive(self): bool

Returns true if the sign bit of the decimal is positive.

pub fn is_sign_negative(self): bool

Returns true if the sign bit of the decimal is negative.

pub fn is_integer(self): bool

Returns true if the decimal number has zero fractional part (is equal to an integer)

pub fn trunc(self): Decimal

Returns a new decimal integral with no fractional portion. This is a true truncation whereby no rounding is performed.

pub fn normalize(self): Decimal

Strips any trailing zero's from a decimal and converts -0 to 0.

pub fn fract(self): Decimal

Returns a new decimal representing the fractional portion of the number.

pub fn floor(self): Decimal

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

pub fn ceil(self): Decimal

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

pub fn abs(self): Decimal

Returns the absolute value

pub fn operator-:1(self): Decimal

pub fn operator%:2(self, b: Decimal): Decimal

pub fn operator/:2(self, b: Decimal): Decimal

pub fn operator*:2(self, b: Decimal): Decimal

pub fn operator-:2(self, b: Decimal): Decimal

pub fn operator+:2(self, b: Decimal): Decimal

pub fn operator<=:2(self, b: Decimal): bool

pub fn operator<:2(self, b: Decimal): bool

pub fn operator>=:2(self, b: Decimal): bool

pub fn operator>:2(self, b: Decimal): bool

pub fn operator!=:2(self, b: Decimal): bool

pub fn operator==:2(self, b: Decimal): bool

pub fn inspect(self): string

pub fn to_string(self): string

pub fn to_float(self): float throws DecimalError

pub fn to_int(self): int throws DecimalError

pub fn parse(value: string, radix: int = 10): Decimal throws DecimalError

Parse a string to decimal.

If the string is a valid decimal, return decimal value, else raise DecimalError.

The radix is the base of the number, default is 10.

let n = try! Decimal.parse("123.456");
assert_eq n.to_string(), "123.456";

let n = try! Decimal.parse("123.456", radix: 16);
assert_eq n.to_string(), "1193.046";

pub fn from_int(value: int): Decimal

pub fn from_float(value: float): Decimal throws DecimalError