dashu 0.6.2

A pure-Rust library set of arbitrary-precision numbers (big numbers) for math and numerics, a native alternative to GNU GMP + MPFR + MPC. Ergonomics and readability come first, with speed and memory usage optimized enough for real workloads. Full no_std, MSRV 1.68; integers, floats, rationals, and complex numbers with configurable precision and rounding, literal macros, and optional serde, rand, num-traits, rkyv, zeroize.
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96

//! Test for importing items from dashu, and do basic operations

use dashu::{rational::Relaxed, *};

#[test]
#[rustfmt::skip::macros(fbig, cbig)]
fn test_macros() {
    // small numbers
    const A: Natural = ubig!(1234);
    const B: Integer = ibig!(-1234);
    assert_eq!(A + B, ibig!(0));

    const C: Real = fbig!(0x1234p-4);
    const D: Decimal = dbig!(12.34);
    assert!(C.to_decimal().value() > D);

    const E: Rational = rbig!(2 / 5);
    const F: Relaxed = rbig!(~2/7);
    assert!(E.relax() > F);

    const G: Complex = cbig!(0x1234p-4-0x5678p8i);
    assert!(G < Complex::from(C));

    // large numbers
    let a = ubig!(0xfffffffffffffffffffffffffffffffffffffffffffffffe);
    let b = ibig!(-0xffffffffffffffffffffffffffffffffffffffffffffffff);
    assert_eq!(a + b, ibig!(-1));

    let c = fbig!(0xffffffffffffffffffffffffffffffffffffffffffffffffp-192);
    let d = dbig!(999999999999999999999999999999999999999999999999999999999999e-60);
    assert!(c < d.to_binary().value());

    let e = rbig!(
        0xfffffffffffffffffffffffffffffffffffffffffffffffe
            / 0xffffffffffffffffffffffffffffffffffffffffffffffff
    );
    let f = rbig!(~
        999999999999999999999999999999999999999999999999999999999998
            / 999999999999999999999999999999999999999999999999999999999999);
    assert!(e < f.canonicalize());

    let g = cbig!(
        0xfffffffffffffffffffffffffffffffffffffffffffffffep-192 +
        0xffffffffffffffffffffffffffffffffffffffffffffffffp192 i
    );
    assert!(g < Complex::from(c));
}

#[test]
#[rustfmt::skip::macros(static_fbig, static_cbig, cbig)]
fn test_static_macros() {
    static SA: &Natural = static_ubig!(1234);
    static SB: &Integer = static_ibig!(-1234);
    assert_eq!(SA + SB, ibig!(0));

    static SC: &Real = static_fbig!(0x1234p-4);
    static SD: &Decimal = static_dbig!(12.34);
    assert!(SC.to_decimal().value() > *SD);

    static SE: &Rational = static_rbig!(2 / 5);
    static SF: &Relaxed = static_rbig!(~2/7);
    assert!(SE.as_relaxed() > SF);

    static SG: &Complex = static_cbig!(3+4i);
    assert_eq!(*SG, cbig!(3, 4));

    static BA: &Natural = static_ubig!(0xfffffffffffffffffffffffffffffffffffffffffffffffe);
    static BB: &Integer = static_ibig!(-0xffffffffffffffffffffffffffffffffffffffffffffffff);
    assert_eq!(BA + BB, ibig!(-1));

    static BC: &Real = static_fbig!(0xffffffffffffffffffffffffffffffffffffffffffffffffp-192);
    static BD: &Decimal =
        static_dbig!(999999999999999999999999999999999999999999999999999999999999e-60);
    assert!(*BC < BD.clone().with_base_and_precision(200).value());

    static BE: &Rational = static_rbig!(
        0xfffffffffffffffffffffffffffffffffffffffffffffffe
            / 0xffffffffffffffffffffffffffffffffffffffffffffffff
    );
    static BF: &Relaxed = static_rbig!(~
        999999999999999999999999999999999999999999999999999999999998
            / 999999999999999999999999999999999999999999999999999999999999);
    assert!(*BE < BF.clone().canonicalize());

    static BG: &Complex = static_cbig!(
        0xffffffffffffffffffffffffffffffffffffffffffffffff,
        0xffffffffffffffffffffffffffffffffffffffffffffffff
    );
    assert_eq!(
        *BG,
        cbig!(
            0xffffffffffffffffffffffffffffffffffffffffffffffff,
            0xffffffffffffffffffffffffffffffffffffffffffffffff
        )
    );
}