musli_core/de/
decode_packed.rs

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
use super::Decoder;

/// Trait governing how a type is decoded as a packed value.
///
/// Packed encodings are ones where data follow one after another, with no
/// "metadata" indicating when one value starts and another stops.
///
/// This is typically used automatically through the `#[musli(packed)]`
/// attribute through the [`Decode` derive].
///
/// [`Decode` derive]: https://docs.rs/musli/latest/musli/help/derives/
///
/// # Examples
///
/// ```
/// use musli::Decode;
///
/// #[derive(Decode)]
/// struct Packed {
///     #[musli(packed)]
///     data: (u32, u32),
/// }
/// ```
///
/// Implementing manually:
///
/// ```
/// use musli::{Decode, Decoder};
/// use musli::de::SequenceDecoder;
///
/// struct Packed {
///     data: (u32, u32),
/// }
///
/// impl<'de, M> Decode<'de, M> for Packed {
///     fn decode<D>(cx: &D::Cx, decoder: D) -> Result<Self, D::Error>
///     where
///         D: Decoder<'de>,
///     {
///         decoder.decode_pack(|pack| {
///             Ok(Self {
///                 data: (pack.next()?, pack.next()?),
///             })
///         })
///     }
/// }
/// ```
pub trait DecodePacked<'de, M>: Sized {
    /// Decode the given input as bytes.
    fn decode_packed<D>(cx: &D::Cx, decoder: D) -> Result<Self, D::Error>
    where
        D: Decoder<'de, Mode = M>;
}