hexutil 0.1.0

A macro to implement common traits to work with hexadecimal values
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
97
98
99
100
101
102
103
104
105
106
107
108
109

#[doc(hidden)]
#[macro_export]
macro_rules! private_impl_to_hex {
    ($ty:ident, $len:expr, |$self:ident| $to_hex:expr) => {
        #[doc(hidden)]
        impl $crate::unstable::ToHexCore for $ty {
            type Bytes = [u8; $len];
            type Buffer = [u8; $len * 2];
            fn create_buffer(_len: usize) -> Self::Buffer {
                [0; $len * 2]
            }
            fn buffer_as_bytes(buffer: &mut Self::Buffer) -> &mut [u8] {
                buffer
            }
            fn to_binary_bytes(&$self) -> Self::Bytes {
                $to_hex
            }
            fn as_binary_bytes<'a>(&'a $self, bytes: &'a Self::Bytes) -> &'a [u8] {
                bytes
            }
        }
        impl $crate::ToHex for $ty {}
    };
    ($ty:ident, $len:expr, |&$self:ident| $to_hex:expr) => {
        #[doc(hidden)]
        impl $crate::unstable::ToHexCore for $ty {
            type Bytes = ();
            type Buffer = [u8; $len * 2];
            fn create_buffer(_len: usize) -> Self::Buffer {
                [0; $len * 2]
            }
            fn buffer_as_bytes(buffer: &mut Self::Buffer) -> &mut [u8] {
                buffer
            }
            fn to_binary_bytes(&self) -> Self::Bytes {
                ()
            }
            fn as_binary_bytes(&$self, _bytes: &Self::Bytes) -> &[u8] {
                $to_hex
            }
        }
        impl $crate::ToHex for $ty {}
    };
}

#[doc(hidden)]
#[macro_export]
macro_rules! private_to_hex_preset {
    ($ty:ident, default) => {
        $crate::private_to_hex_preset!($ty, convert);
        $crate::private_to_hex_preset!($ty, serde);
    };
    ($ty:ident, convert) => {
        $crate::private_to_hex_preset!($ty, Display);
    };
    ($ty:ident, Display) => {
        impl ::core::fmt::Display for $ty {
            fn fmt(&self, f: &mut ::core::fmt::Formatter) -> ::core::fmt::Result {
                $crate::unstable::with_hex_str(self, |s| f.write_str(s))
            }
        }
    };
    ($ty:ident, serde) => {
        $crate::private_to_hex_preset!($ty, Serialize);
    };
    ($ty:ident, Serialize) => {
        impl $crate::private::Serialize for $ty {
            fn serialize<S>(&self, serializer: S) -> Result<S::Ok, S::Error>
            where
                S: $crate::private::Serializer,
            {
                $crate::unstable::serde::serialize(serializer, self)
            }
        }
    };
}

#[doc(hidden)]
#[macro_export]
macro_rules! private_to_hex_presets {
    ($ty:ident,) => {};
    ($ty:ident, $preset:ident, $($presets:ident,)*) => {
        $crate::private_to_hex_preset!($ty, $preset);
        $crate::private_to_hex_presets!($ty, $($presets,)*);
    };
}

/// Implement common traits for binary representable data (to hex only).
///
/// See [crate-level documentation](index.html) for more information.
#[macro_export]
macro_rules! impl_to_hex {
    ($ty:ident, $len:expr, |$self:ident| $to_hex:expr $(,)?) => {
        $crate::impl_to_hex!($ty, $len, |$self| $to_hex, [default]);
    };
    ($ty:ident, $len:expr, |&$self:ident| $to_hex:expr $(,)?) => {
        $crate::impl_to_hex!($ty, $len, |&$self| $to_hex, [default]);
    };
    ($ty:ident, $len:expr, |$self:ident| $to_hex:expr, [$($preset:ident),* $(,)?] $(,)?) => {
        $crate::private_impl_to_hex!($ty, $len, |$self| $to_hex);
        $crate::private_metadata!($ty, $len, $($preset,)*);
        $crate::private_to_hex_presets!($ty, $($preset,)*);
    };
    ($ty:ident, $len:expr, |&$self:ident| $to_hex:expr, [$($preset:ident),* $(,)?] $(,)?) => {
        $crate::private_impl_to_hex!($ty, $len, |&$self| $to_hex);
        $crate::private_metadata!($ty, $len, $($preset,)*);
        $crate::private_to_hex_presets!($ty, $($preset,)*);
    };
}