arbi 0.7.0

Arbitrary Precision Integer
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

/*
Copyright 2024-2025 Owain Davies
SPDX-License-Identifier: Apache-2.0 OR MIT
*/

use crate::{base::DEC, Arbi};
use core::fmt;

/// Outputs the base-10 (decimal) representation of an `Arbi` integer.
///
/// # Examples
/// ```
/// use arbi::Arbi;
/// let a = Arbi::from(12345);
/// assert_eq!(format!("{a}"), "12345");
/// let b = Arbi::from(-12345);
/// assert_eq!(format!("{b}"), "-12345");
/// let zero = Arbi::zero();
/// assert_eq!(format!("{zero}"), "0");
/// ```
impl fmt::Display for Arbi {
    fn fmt(&self, f: &mut fmt::Formatter<'_>) -> fmt::Result {
        write!(f, "{}", self.to_string_base(DEC))
    }
}

#[cfg(test)]
mod tests {
    use super::*;
    use crate::util::test::{get_seedable_rng, get_uniform_die, Distribution};
    use crate::{SDDigit, SDigit, SQDigit};
    use alloc::format;
    use alloc::string::ToString;

    #[test]
    fn test_display_zero() {
        let arbi = Arbi::zero();
        assert_eq!(format!("{}", arbi), "0");
    }

    #[test]
    fn test_display_positive() {
        let arbi = Arbi::from(1234);
        assert_eq!(format!("{}", arbi), "1234");
    }

    #[test]
    fn test_display_negative() {
        let arbi = Arbi::from(-1234);
        assert_eq!(format!("{}", arbi), "-1234");
    }

    #[test]
    fn smoke() {
        let (mut rng, _) = get_seedable_rng();

        let die_s = get_uniform_die(SDigit::MIN, SDigit::MAX);
        let die_m = get_uniform_die(SDDigit::MIN, SDDigit::MAX);
        let die_l = get_uniform_die(SQDigit::MIN, SQDigit::MAX);

        for i in i16::MIN..i16::MAX {
            let rs = die_s.sample(&mut rng);
            let rm = die_m.sample(&mut rng);
            let rl = die_l.sample(&mut rng);

            assert_eq!(format!("{}", Arbi::from(rs)), rs.to_string());
            assert_eq!(format!("{}", Arbi::from(rm)), rm.to_string());
            assert_eq!(format!("{}", Arbi::from(rl)), rl.to_string());

            assert_eq!(format!("{}", Arbi::from(i)), i.to_string());
        }
    }
}