dec128

Macro dec128 

Source
macro_rules! dec128 {
    ($($body:tt)*) => { ... };
}
Expand description

A macro to construct 128-bit signed D128 decimal from literals in compile time.

Const-evaluated in compile time macro-helper can be used for definitions of constants or variables whose value is known in compile time.

§Examples:

Basic usage:

use fastnum::*;

const N: D128 = dec128!(1.23456789);
assert!(!N.is_zero());

let num = dec128!(0);
assert!(num.is_zero());

const A: D128 = dec128!(5);
const B: D128 = dec128!(1_000);
const C: D128 = A.div(B);

assert_eq!(C, dec128!(0.005));

§Static assertions:

// The below example will fail to compile, as the function will panic at compile time:
use fastnum::{dec128, D128}

// Gives a compile error of "error[E0080]: evaluation of constant value failed...
// the evaluated program panicked at 'attempt to parse decimal from string containing invalid digit'",
const N: D128 = dec128!(A1.23456789);

This allows you to perform all the necessary checks such as potentialy overflow or calculation accuracy loss and others at the compile time. Protect from unexpected errors in runtime.