#decimal #financial #fixed #precision

macro rust_decimal_macro_impls

Shorthand macros to assist creating Decimal types. Do not depend on this directly; use rust_decimal_macros

13 stable releases

1.7.0 Jul 11, 2020
1.4.1 Apr 10, 2020
1.4.0 Mar 23, 2020
1.1.0 Dec 27, 2019
0.11.1 Feb 11, 2019

#704 in Data structures

Download history 18/week @ 2022-03-07 73/week @ 2022-03-14 65/week @ 2022-03-21 30/week @ 2022-03-28 24/week @ 2022-04-04 36/week @ 2022-04-11 20/week @ 2022-04-18 111/week @ 2022-04-25 152/week @ 2022-05-02 74/week @ 2022-05-09 360/week @ 2022-05-16 104/week @ 2022-05-23 147/week @ 2022-05-30 73/week @ 2022-06-06 18/week @ 2022-06-13 22/week @ 2022-06-20

296 downloads per month

MIT license

345KB
7K SLoC

Decimal   Build Status Latest Version

A Decimal implementation written in pure Rust suitable for financial calculations that require significant integral and fractional digits with no round-off errors.

The binary representation consists of a 96 bit integer number, a scaling factor used to specify the decimal fraction and a 1 bit sign. Because of this representation, trailing zeros are preserved and may be exposed when in string form. These can be truncated using the normalize or round_dp functions.

Documentation

Usage

Decimal numbers can be created in a few distinct ways. The easiest and most optimal method of creating a Decimal is to use the procedural macro within the rust_decimal_macros crate:

// Procedural macros need importing directly
use rust_decimal_macros::*;

let number = dec!(-1.23);

Alternatively you can also use one of the Decimal number convenience functions:

use rust_decimal::prelude::*;

// Using an integer followed by the decimal points
let scaled = Decimal::new(202, 2); // 2.02

// From a string representation
let from_string = Decimal::from_str("2.02").unwrap(); // 2.02

// Using the `Into` trait
let my_int : Decimal = 3i32.into();

// Using the raw decimal representation
// 3.1415926535897932384626433832
let pi = Decimal::from_parts(1102470952, 185874565, 1703060790, false, 28);

Features

db-postgres

This feature enables a PostgreSQL communication module. It allows for reading and writing the Decimal type by transparently serializing/deserializing into the NUMERIC data type within PostgreSQL.

db-tokio-postgres

Enables the tokio postgres module allowing for async communication with PostgreSQL.

db-diesel-postgres

Enable diesel PostgreSQL support.

serde-float

Enable this so that JSON serialization of Decimal types are sent as a float instead of a string (default).

e.g. with this turned on, JSON serialization would output:

{
  "value": 1.234
}

serde-bincode

Since bincode does not specify type information, we need to ensure that a type hint is provided in order to correctly be able to deserialize. Enabling this feature on it's own will force deserialization to use deserialize_str instead of deserialize_any.

If, for some reason, you also have serde-float enabled then this will use deserialize_f64 as a type hint. Because converting to f64 loses precision, it's highly recommended that you do NOT enable this feature when working with bincode. That being said, this will only use 8 bytes so is slightly more efficient in regards to storage size.

Dependencies

~335–580KB
~11K SLoC