moonbitlang/x/decimal - mooncakes.io

moonbitlang/x/decimal does not have a README file

Decimal

pub struct Decimal {
  coefficient : @moonbitlang/core/bigint.BigInt
BigInt
  scale : Int
} derive(@moonbitlang/core/debug.Debug
Debug)

Arbitrary precision decimal type for exact decimal arithmetic.

This type is designed for financial calculations and other applications that require exact decimal representation without floating-point errors.

The decimal is represented as a coefficient (BigInt) and a scale (Int):

coefficient: The significant digits as a BigInt
scale: The number of decimal places (0 <= scale <= max_scale)

For example: 123.45 is represented as coefficient=12345, scale=2

Invariants:

0 <= scale <= max_scale (default 28)
coefficient and scale are normalized (no trailing zeros in coefficient)
Zero is represented as coefficient=0, scale=0

Example:

test {
  let price = match @decimal.Decimal::from_string("19.99") {
    Some(p) => p
    None => fail("Invalid price")
  }
  let tax = match @decimal.Decimal::from_string("0.08") {
    Some(t) => t
    None => fail("Invalid tax rate")
  }
  let total = price + tax
  inspect(total.to_string(), content="20.07")
}

impl Add for Decimal

impl Compare for Decimal

impl Default for Decimal

impl Div for Decimal

impl Eq for Decimal

impl Hash for Decimal

impl Mul for Decimal

impl Neg for Decimal

impl Show for Decimal

impl Sub for Decimal

impl ToJson for Decimal

impl FromJson for Decimal

impl Arbitrary for Decimal

Decimal::abs

source

fn Decimal::abs(self : Decimal) -> Decimal

Returns the absolute value of the decimal.

Decimal::add

source

#deprecated("`Decimal::add` is deprecated, use `Add::add` instead.")
fn Decimal::add(self : Decimal, other : Decimal) -> Decimal

Decimal::arbitrary

source

#deprecated("`Decimal::arbitrary` is deprecated, use `@moonbitlang/core/quickcheck.Arbitrary::arbitrary` instead.")
fn Decimal::arbitrary(size : Int, rs : @moonbitlang/core/quickcheck/splitmix.RandomState
RandomState) -> Decimal

Decimal::coefficient

source

fn Decimal::coefficient(self : Decimal) -> @moonbitlang/core/bigint.BigInt
BigInt

Returns the coefficient (significant digits) of the decimal.

Decimal::compare

source

#deprecated("`Decimal::compare` is deprecated, use `Compare::compare` instead.")
fn Decimal::compare(self : Decimal, other : Decimal) -> Int

Decimal::default

source

#deprecated("`Decimal::default` is deprecated, use `Default::default` instead.")
fn Decimal::default() -> Decimal

Decimal::div

source

#deprecated("`Decimal::div` is deprecated, use `Div::div` instead.")
fn Decimal::div(self : Decimal, other : Decimal) -> Decimal

Decimal::equal

source

#deprecated("`Decimal::equal` is deprecated, use `Eq::equal` instead.")
fn Decimal::equal(self : Decimal, other : Decimal) -> Bool

Decimal::from_bigint

source

fn Decimal::from_bigint(n : @moonbitlang/core/bigint.BigInt
BigInt) -> Decimal

Creates a decimal from a BigInt.

Parameters:

n : The BigInt value

Returns a decimal with scale 0.

Example:

test {
  let d = @decimal.Decimal::from_bigint(12345678901234567890N)
  inspect(d.to_string(), content="12345678901234567890")
}

Decimal::from_double

source

fn Decimal::from_double(d : Double, precision : Int) -> Decimal?

Creates a decimal from a double with specified precision.

Parameters:

d : The double value
precision : Number of decimal places

Returns Some(decimal) if conversion succeeds, None otherwise.

Example:

test {
  let d = match @decimal.Decimal::from_double(3.14159, 5) {
    Some(d) => d
    None => fail("Invalid double conversion")
  }
  inspect(d.to_string(), content="3.14159")
}

Decimal::from_int

source

fn Decimal::from_int(n : Int) -> Decimal

Creates a decimal from an integer.

Parameters:

n : The integer value

Returns a decimal with scale 0.

Example:

test {
  let d = @decimal.Decimal::from_int(42)
  inspect(d.to_string(), content="42")
}

Decimal::from_json

source

#deprecated("`Decimal::from_json` is deprecated, use `@moonbitlang/core/json.FromJson::from_json` instead.")
fn Decimal::from_json(json : Json, path : @moonbitlang/core/json.JsonPath
JsonPath) -> Decimal raise @moonbitlang/core/json.JsonDecodeError
JsonDecodeError

Decimal::from_string

source

fn Decimal::from_string(s : String) -> Decimal?

Creates a decimal from a string representation.

Parameters:

s : String representation of the decimal (e.g., "123.45", "-0.001")

Returns Some(decimal) if parsing succeeds, None otherwise.

Example:

test {
  let d = match @decimal.Decimal::from_string("123.45") {
    Some(d) => d
    None => fail("Invalid decimal string")
  }
  inspect(d.to_string(), content="123.45")
}

Decimal::hash

source

#deprecated("`Decimal::hash` is deprecated, use `Hash::hash` instead.")
fn Decimal::hash(self : Decimal) -> Int

Decimal::hash_combine

source

#deprecated("`Decimal::hash_combine` is deprecated, use `Hash::hash_combine` instead.")
fn Decimal::hash_combine(self : Decimal, hasher : Hasher) -> Unit

Decimal::is_negative

source

fn Decimal::is_negative(self : Decimal) -> Bool

Checks if the decimal is negative.

Decimal::is_positive

source

fn Decimal::is_positive(self : Decimal) -> Bool

Checks if the decimal is positive.

Decimal::is_zero

source

fn Decimal::is_zero(self : Decimal) -> Bool

Checks if the decimal is zero.

Decimal::mul

source

#deprecated("`Decimal::mul` is deprecated, use `Mul::mul` instead.")
fn Decimal::mul(self : Decimal, other : Decimal) -> Decimal

Decimal::neg

source

#deprecated("`Decimal::neg` is deprecated, use `Neg::neg` instead.")
fn Decimal::neg(self : Decimal) -> Decimal

Decimal::new

source

fn Decimal::new(coefficient : @moonbitlang/core/bigint.BigInt
BigInt, scale : Int) -> Decimal?

Creates a decimal from a coefficient and scale.

Parameters:

coefficient : The significant digits as a BigInt
scale : The number of decimal places

Returns Some(decimal) if the scale is valid, None otherwise.

Example:

test {
  let d = match @decimal.Decimal::new(12345N, 2) {
    Some(d) => d
    None => fail("Invalid decimal")
  } // 123.45
  inspect(d.to_string(), content="123.45")
}

Decimal::not_equal

source

#deprecated("`Decimal::not_equal` is deprecated, use `Eq::not_equal` instead.")
fn Decimal::not_equal(x : Decimal, y : Decimal) -> Bool

Decimal::op_ge

source

#deprecated("`Decimal::op_ge` is deprecated, use `Compare::op_ge` instead.")
fn Decimal::op_ge(x : Decimal, y : Decimal) -> Bool

Decimal::op_gt

source

#deprecated("`Decimal::op_gt` is deprecated, use `Compare::op_gt` instead.")
fn Decimal::op_gt(x : Decimal, y : Decimal) -> Bool

Decimal::op_le

source

#deprecated("`Decimal::op_le` is deprecated, use `Compare::op_le` instead.")
fn Decimal::op_le(x : Decimal, y : Decimal) -> Bool

Decimal::op_lt

source

#deprecated("`Decimal::op_lt` is deprecated, use `Compare::op_lt` instead.")
fn Decimal::op_lt(x : Decimal, y : Decimal) -> Bool

Decimal::output

source

#deprecated("`Decimal::output` is deprecated, use `Show::output` instead.")
fn Decimal::output(self : Decimal, logger : &Logger) -> Unit

Decimal::round

source

fn Decimal::round(self : Decimal, places : Int) -> Decimal?

Rounds the decimal to the specified number of decimal places.

Parameters:

self : The decimal to round
places : Number of decimal places (0 <= places <= max_scale)

Returns Some(decimal) if places is valid, None otherwise.

Example:

test {
  let d = match @decimal.Decimal::from_string("3.14159") {
    Some(d) => d
    None => fail("Invalid decimal string")
  }
  let rounded = match d.round(2) {
    Some(r) => r
    None => fail("Invalid rounding")
  }
  inspect(rounded.to_string(), content="3.14")
}

Decimal::scale

source

fn Decimal::scale(self : Decimal) -> Int

Returns the scale (number of decimal places) of the decimal.

Decimal::scale_to

source

fn Decimal::scale_to(self : Decimal, new_scale : Int) -> Decimal?

Scales the decimal to have the specified number of decimal places.

Parameters:

self : The decimal to scale
new_scale : New number of decimal places (0 <= new_scale <= max_scale)

Returns Some(decimal) if new_scale is valid, None otherwise.

Example:

test {
  let d = match @decimal.Decimal::from_string("123.45") {
    Some(d) => d
    None => fail("Invalid decimal string")
  }
  let scaled = match d.scale_to(4) {
    Some(s) => s
    None => fail("Invalid scaling")
  }
  inspect(scaled.to_string(), content="123.4500")
}

Decimal::signum

source

fn Decimal::signum(self : Decimal) -> Int

Returns the sign of the decimal: -1, 0, or 1.

Decimal::sub

source

#deprecated("`Decimal::sub` is deprecated, use `Sub::sub` instead.")
fn Decimal::sub(self : Decimal, other : Decimal) -> Decimal

Decimal::to_bigint

source

fn Decimal::to_bigint(self : Decimal) -> @moonbitlang/core/bigint.BigInt
BigInt

Converts the decimal to a BigInt by truncating towards zero.

Example:

test {
  let d = match @decimal.Decimal::from_string("123.99") {
    Some(d) => d
    None => fail("Invalid decimal string")
  }
  inspect(d.to_bigint(), content="123")
}

Decimal::to_double

source

fn Decimal::to_double(self : Decimal) -> Double

Converts the decimal to a double (with potential precision loss).

Warning: This conversion may lose precision for large numbers or high precision decimals.

Example:

test {
  let d = match @decimal.Decimal::from_string("3.14159") {
    Some(d) => d
    None => fail("Invalid decimal string")
  }
  inspect(d.to_double(), content="3.14159")
}

Decimal::to_int

source

fn Decimal::to_int(self : Decimal) -> Int?

Converts the decimal to an integer by truncating towards zero.

Returns Some(int) if the decimal fits in an Int, None otherwise.

Example:

test {
  let d = match @decimal.Decimal::from_string("123.99") {
    Some(d) => d
    None => fail("Invalid decimal string")
  }
  debug_inspect(d.to_int(), content="Some(123)")
}

Decimal::to_json

source

#deprecated("`Decimal::to_json` is deprecated, use `ToJson::to_json` instead.")
fn Decimal::to_json(self : Decimal) -> Json

Decimal::to_repr

source

#deprecated("`Decimal::to_repr` is deprecated, use `@moonbitlang/core/debug.Debug::to_repr` instead.")
fn Decimal::to_repr(Decimal) -> @moonbitlang/core/debug.Repr
Repr

Decimal::to_string

source

fn Decimal::to_string(self : Decimal) -> String

Converts the decimal to a string representation.

Returns a string in the format "integer.fractional" or "integer".

Example:

test {
  let d = match @decimal.Decimal::from_string("123.45") {
    Some(d) => d
    None => fail("Invalid decimal string")
  }
  inspect(d.to_string(), content="123.45")
}

Decimal::truncate

source

fn Decimal::truncate(self : Decimal, places : Int) -> Decimal?

Truncates the decimal to the specified number of decimal places.

Parameters:

self : The decimal to truncate
places : Number of decimal places (0 <= places <= max_scale)

Returns Some(decimal) if places is valid, None otherwise.

Example:

test {
  let d = match @decimal.Decimal::from_string("3.14159") {
    Some(d) => d
    None => fail("Invalid decimal string")
  }
  let truncated = match d.truncate(2) {
    Some(t) => t
    None => fail("Invalid truncation")
  }
  inspect(truncated.to_string(), content="3.14")
}

max_scale

source

let max_scale : Int

Maximum number of decimal places (scale) allowed.

neg_one

source

fn neg_one() -> Decimal

Returns the negative one decimal value.

one

source

fn one() -> Decimal

Returns the one decimal value.

zero

source

fn zero() -> Decimal

Returns the zero decimal value.

Source Files

decimal.mbt

Site source Report issue Packages Build queue Skills Statistics

#Decimal

#Decimal::abs

#Decimal::add

#Decimal::arbitrary

#Decimal::coefficient

#Decimal::compare

#Decimal::default

#Decimal::div

#Decimal::equal

#Decimal::from_bigint

#Decimal::from_double

#Decimal::from_int

#Decimal::from_json

#Decimal::from_string

#Decimal::hash

#Decimal::hash_combine

#Decimal::is_negative

#Decimal::is_positive

#Decimal::is_zero

#Decimal::mul

#Decimal::neg

#Decimal::new

#Decimal::not_equal

#Decimal::op_ge

#Decimal::op_gt

#Decimal::op_le

#Decimal::op_lt

#Decimal::output

#Decimal::round

#Decimal::scale

#Decimal::scale_to

#Decimal::signum

#Decimal::sub

#Decimal::to_bigint

#Decimal::to_double

#Decimal::to_int

#Decimal::to_json

#Decimal::to_repr

#Decimal::to_string

#Decimal::truncate

#max_scale

#neg_one

#one

#zero

Source Files

Decimal

Decimal::abs

Decimal::add

Decimal::arbitrary

Decimal::coefficient

Decimal::compare

Decimal::default

Decimal::div

Decimal::equal

Decimal::from_bigint

Decimal::from_double

Decimal::from_int

Decimal::from_json

Decimal::from_string

Decimal::hash

Decimal::hash_combine

Decimal::is_negative

Decimal::is_positive

Decimal::is_zero

Decimal::mul

Decimal::neg

Decimal::new

Decimal::not_equal

Decimal::op_ge

Decimal::op_gt

Decimal::op_le

Decimal::op_lt

Decimal::output

Decimal::round

Decimal::scale

Decimal::scale_to

Decimal::signum

Decimal::sub

Decimal::to_bigint

Decimal::to_double

Decimal::to_int

Decimal::to_json

Decimal::to_repr

Decimal::to_string

Decimal::truncate

max_scale

neg_one

one

zero