thruput-xdr 0.63.0

Bindings for Thruput protocol structures
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

use core::fmt;

/// Borrowed bytes whose `Debug` and `Display` output is lowercase hex with
/// no prefix or separators, e.g. `deadbeef`.
///
/// Construct it with [`hex_encode`].
pub struct Hex<'a>(&'a [u8]);

impl<'a> fmt::Debug for Hex<'a> {
    fn fmt(&self, f: &mut fmt::Formatter<'_>) -> Result<(), fmt::Error> {
        for b in self.0 {
            write!(f, "{:02x}", b)?;
        }
        Ok(())
    }
}

/// Identical to the `Debug` form. Raw bytes have no second, friendlier
/// rendering to offer, and a caller embedding them in a `{}` format string
/// wants the same hex a `{:?}` would give.
impl<'a> fmt::Display for Hex<'a> {
    fn fmt(&self, f: &mut fmt::Formatter<'_>) -> Result<(), fmt::Error> {
        fmt::Debug::fmt(self, f)
    }
}

/// Wraps `b` so `{:?}` and `{}` format it as lowercase hex, for readable
/// opaque payloads and binary inspection without allocating. For typed
/// identifiers, use [`crate::base58::base58_encode`].
pub fn hex_encode<'a, B: AsRef<[u8]>>(b: &'a B) -> Hex<'a> {
    Hex(b.as_ref())
}