wrap_array/
wrap_array.rs

1// SPDX-License-Identifier: CC0-1.0
2
3//! Hex encode/decode a type that wraps an array.
4//!
5//! Creates a simple array wrapper types using implementations of the standard library `fmt` traits.
6
7use core::fmt;
8use core::str::FromStr;
9
10use hex_conservative::{self as hex, DecodeFixedLengthBytesError, DisplayHex as _};
11
12fn main() {
13    let hex = "deadbeefcafebabedeadbeefcafebabedeadbeefcafebabedeadbeefcafebabe";
14    println!("\nParse from hex: {}\n", hex);
15
16    let array = hex::decode_to_array::<32>(hex).expect("failed to parse array");
17    let wrap = Wrap::from_str(hex).expect("failed to parse wrapped array from hex string");
18
19    println!("Print an array using traits from the standard libraries `fmt` module along with the provided implementation of `DisplayHex`:\n");
20    println!("LowerHex: {:x}", array.as_hex());
21    println!("UpperHex: {:X}", array.as_hex());
22    println!("Display: {}", array.as_hex());
23    println!("Debug: {:?}", array.as_hex());
24    println!("Debug pretty: {:#?}", array.as_hex());
25
26    println!("\n");
27
28    println!(
29        "Print the wrapped array directly using traits from the standard libraries `fmt` module:\n"
30    );
31    println!("LowerHex: {:x}", wrap);
32    println!("UpperHex: {:X}", wrap);
33    println!("Display: {}", wrap);
34    println!("Debug: {:?}", wrap);
35    println!("Debug pretty: {:#?}", wrap);
36
37    #[cfg(feature = "alloc")]
38    {
39        let array_hex = array.to_lower_hex_string();
40        let other = array.as_hex().to_string();
41        assert_eq!(array_hex, other);
42
43        let wrap_hex = wrap.to_string();
44        assert_eq!(array_hex, wrap_hex);
45    }
46}
47
48pub struct Wrap([u8; 32]);
49
50impl fmt::Debug for Wrap {
51    fn fmt(&self, f: &mut core::fmt::Formatter) -> core::fmt::Result {
52        fmt::Formatter::debug_tuple(f, "Wrap").field(&self.0.as_hex()).finish()
53    }
54}
55
56impl fmt::Display for Wrap {
57    fn fmt(&self, f: &mut core::fmt::Formatter) -> core::fmt::Result {
58        fmt::Display::fmt(&self.0.as_hex(), f)
59    }
60}
61
62impl fmt::LowerHex for Wrap {
63    fn fmt(&self, f: &mut core::fmt::Formatter) -> core::fmt::Result {
64        fmt::LowerHex::fmt(&self.0.as_hex(), f)
65    }
66}
67
68impl fmt::UpperHex for Wrap {
69    fn fmt(&self, f: &mut core::fmt::Formatter) -> core::fmt::Result {
70        fmt::LowerHex::fmt(&self.0.as_hex(), f)
71    }
72}
73
74impl FromStr for Wrap {
75    type Err = DecodeFixedLengthBytesError;
76    fn from_str(s: &str) -> Result<Self, Self::Err> { Ok(Self(hex::decode_to_array::<32>(s)?)) }
77}
wrap_array/wrap_array.rs

wrap_array/
wrap_array.rs
