#decimal #numeric #fixed #precision

decimal-rs

High precision decimal implementation for Rust

30 releases

0.1.30 Jan 6, 2022
0.1.27 Dec 31, 2021
0.1.21 Oct 19, 2021
0.1.14 Jul 10, 2021
0.1.0 Feb 2, 2021

#3 in #numeric

Download history 391/week @ 2021-10-04 673/week @ 2021-10-11 1838/week @ 2021-10-18 2157/week @ 2021-10-25 888/week @ 2021-11-01 849/week @ 2021-11-08 895/week @ 2021-11-15 585/week @ 2021-11-22 554/week @ 2021-11-29 692/week @ 2021-12-06 903/week @ 2021-12-13 508/week @ 2021-12-20 219/week @ 2021-12-27 822/week @ 2022-01-03 1064/week @ 2022-01-10 817/week @ 2022-01-17

2,947 downloads per month
Used in yason

Apache-2.0

210KB
4.5K SLoC

decimal-rs

Apache-2.0 licensed Crate API

High precision decimal with maximum precision of 38.

Feature Flags

  • serde: When this optional dependency is enabled, Decimal implements the serde::Serialize and serde::Deserialize traits.

Usage

To build a decimal, use Decimal:

use decimal_rs::Decimal;

let n1: Decimal = "123".parse().unwrap();
let n2: Decimal = "456".parse().unwrap();
let result = n1 + n2;
assert_eq!(result.to_string(), "579");

To build a decimal from Rust primitive types:

use decimal_rs::Decimal;

let n1 = Decimal::from(123_i32);
let n2 = Decimal::from(456_i32);
let result = n1 + n2;
assert_eq!(result, Decimal::from(579_i32));

Decimal supports high precision arithmetic operations.

use decimal_rs::Decimal;

let n1: Decimal = "123456789.987654321".parse().unwrap();
let n2: Decimal = "987654321.123456789".parse().unwrap();
let result = n1 * n2;
assert_eq!(result.to_string(), "121932632103337905.662094193112635269");

Decimal can be encoded to bytes and decoded from bytes.

use decimal_rs::Decimal;

let n1 = "123456789.987654321".parse::<Decimal>().unwrap();
let mut  bytes = Vec::new();
n1.encode(&mut bytes).unwrap();
let n2 = Decimal::decode(&bytes);
assert_eq!(n1, n2);

Rust Version

This version of decimal-rs requires Rust 1.51 or later.

License

This project is licensed under the Apache-2.0 license (LICENSE or http://www.apache.org/licenses/LICENSE-2.0).

Contribution

Unless you explicitly state otherwise, any contribution intentionally submitted for inclusion in decimal-rs by you, shall be licensed as Apache-2.0, without any additional terms or conditions.

Dependencies

~0.6–1MB
~24K SLoC