deku_string 0.4.1

Encoding/decoding helpers for Deku, String, Vec in fixed, Pascal, .NET and C-style formats with length guarantee.
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

/// Endian value for Deku context
macro_rules! _ctx_endian {
    (endian: little) => {
        Endian::Little
    };
    (endian: big) => {
        Endian::Big
    };
}

macro_rules! _data_type_static {
    (data: u8) => {
        u8
    };
    (data: str) => {
        &str
    };
}

macro_rules! _data_type {
    (data: u8) => {
        u8
    };
    (data: str) => {
        StringDeku
    };
}

macro_rules! _data_convert {
    (data: u8, $var:ident) => {
        $var.to_vec()
    };
    (data: str, $var:ident) => {
        $var.into_iter()
            .map(|&item| StringDeku::new(item))
            .collect::<Vec<StringDeku>>()
    };
}

macro_rules! _deku_ctx {
    (data: u8, ctx: prime, $layout:ident, $endian: ident) => {
        (_ctx_endian!(endian: $endian), paste! {[<LAYOUT_ $layout:upper>]})
    };

    ( data: str, ctx: prime, $layout:ident, $endian: ident)=> {
        (_ctx_endian!(endian: $endian), paste! {[<LAYOUT_ $layout:upper>]}, STRING_CTX)
    };

    (data: u8, ctx: alt, $layout:ident, $endian: ident) => {
        (_ctx_endian!(endian: $endian), paste! {[<LAYOUT_ $layout:upper>]})
    };

    ( data: str, ctx: alt, $layout:ident, $endian: ident)=> {
        (_ctx_endian!(endian: $endian), (paste! {[<LAYOUT_ $layout:upper>]}, STRING_CTX))
    };
}

macro_rules! _deku_ctx_type {
    (data: u8, ctx: prime) => {
        (Endian, VecLayout)
    };

    ( data: str, ctx: prime) => {
        (Endian, VecLayout, (Encoding, StringLayout))
    };

    (data: u8, ctx: alt) => {
        (Endian, VecLayout)
    };

    ( data: str, ctx: alt) => {
        (Endian, (VecLayout, (Encoding, StringLayout)))
    };
}

/// Match value for all supported errors
macro_rules! _match_error {
    (error: assertion) => {
        deku::DekuError::Assertion(_)
    };
    (error: parse) => {
        deku::DekuError::Parse(_)
    };
    (error: incomplete) => {
        deku::DekuError::Incomplete(deku::error::NeedSize { .. })
    };
    (error: io) => {
        deku::DekuError::Io(_)
    };
}

/// Assert for given error
macro_rules! _rejected_check {
    ($value: ident, error: $error: ident) => {
        assert!(
            matches!($value, _match_error!(error: $error)),
            "value doesn't match! {:#?}",
            $value
        )
    };
}

pub(crate) use {
    _ctx_endian, _data_convert, _data_type, _data_type_static, _deku_ctx,
    _deku_ctx_type, _match_error, _rejected_check,
};