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
97
98
//! Uppercase hexadecimal formatting via [`fmt::UpperHex`].
use super::U384;
use core::fmt;
/// Formats a [`U384`] as an uppercase hexadecimal string without leading
/// zeros (except for the value zero itself, which formats as `"0"`).
///
/// Supports the `#` alternate flag for a `0x` prefix, matching the
/// standard library convention for integer types.
///
/// # Examples
///
/// ```
/// use cnfy_uint::u384::U384;
///
/// let v = U384::from_be_limbs([0, 0, 0, 0, 0, 255]);
/// assert_eq!(format!("{:X}", v), "FF");
/// assert_eq!(format!("{:#X}", v), "0xFF");
/// ```
impl fmt::UpperHex for U384 {
fn fmt(&self, f: &mut fmt::Formatter<'_>) -> fmt::Result {
let first_nonzero = self.0.iter().rposition(|&limb| limb != 0);
match first_nonzero {
None => {
if f.alternate() {
f.write_str("0x0")
} else {
f.write_str("0")
}
}
Some(idx) => {
if f.alternate() {
f.write_str("0x")?;
}
write!(f, "{:X}", self.0[idx])?;
let mut i = idx;
while i > 0 {
i -= 1;
write!(f, "{:016X}", self.0[i])?;
}
Ok(())
}
}
}
}
#[cfg(test)]
mod ai_tests {
use super::*;
/// Zero formats as "0".
#[test]
fn zero() {
assert_eq!(format!("{:X}", U384::from_be_limbs([0; 6])), "0");
}
/// Zero with alternate flag formats as "0x0".
#[test]
fn zero_alternate() {
assert_eq!(format!("{:#X}", U384::from_be_limbs([0; 6])), "0x0");
}
/// Small value formats without leading zeros in uppercase.
#[test]
fn small_value() {
let v = U384::from_be_limbs([0, 0, 0, 0, 0, 255]);
assert_eq!(format!("{:X}", v), "FF");
}
/// Value spanning two limbs shows full padding on lower limb.
#[test]
fn two_limbs() {
let v = U384::from_be_limbs([0, 0, 0, 0, 1, 0]);
assert_eq!(format!("{:X}", v), "10000000000000000");
}
/// MAX value fills all 96 hex digits.
#[test]
fn max_value() {
let s = format!("{:X}", U384::MAX);
assert_eq!(s.len(), 96);
assert!(s.chars().all(|c| c == 'F'));
}
/// Alternate flag adds 0x prefix.
#[test]
fn alternate_prefix() {
let v = U384::from_be_limbs([0, 0, 0, 0, 0, 0xCAFE]);
assert_eq!(format!("{:#X}", v), "0xCAFE");
}
/// ONE formats as "1".
#[test]
fn one() {
assert_eq!(format!("{:X}", U384::ONE), "1");
}
}