databuf 0.5.0

This library used to serialize and deserialize structured data in binary format
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

use crate::*;
use std::{
    borrow::Cow,
    cell::{Cell, RefCell},
    rc::Rc,
    sync::Arc,
};

macro_rules! impls {
    [Encode for $($name:ty),*] => ($(
        impl<T: Encode + ?Sized> Encode for $name {
            #[inline]
            fn encode<const CONFIG: u16>(&self, c: &mut (impl Write + ?Sized)) -> io::Result<()> { (**self).encode::<CONFIG>(c) }
        }
    )*);
    [Decode for $($name:ident),*] => ($(
        impl<'de, T: Decode<'de>> Decode<'de> for $name<T> {
            #[inline]
            fn decode<const CONFIG: u16>(c: &mut &'de [u8]) -> Result<Self> { T::decode::<CONFIG>(c).map(Self::from) }
        }
    )*);
}

impls!(Encode for &T, &mut T, Box<T>, Rc<T>, Arc<T>);
impls!(Decode for Box, Rc, Arc, Cell, RefCell);

macro_rules! impl_sp {
    [$($name: ident),*] => ($(
        impl<'de> Decode<'de> for $name<str> {
            #[inline] fn decode<const CONFIG: u16>(c: &mut &'de [u8]) -> Result<Self> {
                <&'de str>::decode::<CONFIG>(c).map(Self::from)
            }
        }
        impl<'de, T: Decode<'de>> Decode<'de> for $name<[T]> {
            #[inline] fn decode<const CONFIG: u16>(c: &mut &'de [u8]) -> Result<Self> {
                Vec::<T>::decode::<CONFIG>(c).map(Self::from)
            }
        }
    )*);
}
impl_sp!(Box, Rc, Arc);

impl<T> Encode for std::marker::PhantomData<T> {
    #[inline]
    fn encode<const CONFIG: u16>(&self, _: &mut (impl Write + ?Sized)) -> io::Result<()> {
        Ok(())
    }
}

impl<T> Decode<'_> for std::marker::PhantomData<T> {
    #[inline]
    fn decode<const CONFIG: u16>(_: &mut &[u8]) -> Result<Self> {
        Ok(std::marker::PhantomData)
    }
}

impl<T: Encode + Copy> Encode for Cell<T> {
    #[inline]
    fn encode<const CONFIG: u16>(&self, c: &mut (impl Write + ?Sized)) -> io::Result<()> {
        self.get().encode::<CONFIG>(c)
    }
}

impl<T: Encode> Encode for RefCell<T> {
    #[inline]
    fn encode<const CONFIG: u16>(&self, c: &mut (impl Write + ?Sized)) -> io::Result<()> {
        self.try_borrow()
            .map_err(utils::invalid_input)?
            .encode::<CONFIG>(c)
    }
}

impl<'a, T> Encode for Cow<'a, T>
where
    T: ?Sized + Encode + ToOwned,
{
    #[inline]
    fn encode<const CONFIG: u16>(&self, c: &mut (impl Write + ?Sized)) -> io::Result<()> {
        (**self).encode::<CONFIG>(c)
    }
}

impl<'de, 'a, T: ?Sized> Decode<'de> for Cow<'a, T>
where
    T: ToOwned,
    T::Owned: Decode<'de>,
{
    #[inline]
    fn decode<const CONFIG: u16>(c: &mut &'de [u8]) -> Result<Self> {
        T::Owned::decode::<CONFIG>(c).map(Cow::Owned)
    }
}