binary-layout 4.0.2

The binary-layout library allows type-safe, inplace, zero-copy access to structured binary data. You define a custom data layout and give it a slice of binary data, and it will allow you to read and write the fields defined in the layout from the binary data without having to copy any of the data. It's similar to transmuting to/from a `#[repr(packed)]` struct, but much safer.
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

use binary_layout::{prelude::*, Data};

mod common;
use common::data_region;

#[test]
fn given_immutableview_when_extractingimmutableref() {
    binary_layout!(layout, LittleEndian, {
        field: u8,
        tail: [u8],
    });

    let storage = data_region(1024, 0);
    let extracted = {
        let view = layout::View::new(&storage);
        view.into_tail()
        // here, the view dies but the extracted reference lives on
    };

    assert_eq!(&data_region(1024, 0)[1..], &*extracted);
}

#[test]
fn given_immutableview_with_reftovec_when_extractingimmutableref() {
    binary_layout!(layout, LittleEndian, {
        field: u8,
        tail: [u8],
    });

    let storage = data_region(1024, 0);
    let extracted: Data<&Vec<u8>> = {
        let view: layout::View<&Vec<u8>> = layout::View::new(&storage);
        view.into_tail()
        // here, the view dies but the extracted reference lives on
    };

    assert_eq!(&data_region(1024, 0)[1..], &*extracted);
}

#[test]
fn given_mutableview_when_extractingimmutableref() {
    binary_layout!(layout, LittleEndian, {
        field: u8,
        tail: [u8],
    });

    let mut storage = data_region(1024, 0);
    let extracted: Data<&mut [u8]> = {
        let view: layout::View<&mut [u8]> = layout::View::new(&mut storage);
        view.into_tail()
    };

    assert_eq!(&data_region(1024, 0)[1..], &*extracted);
}

#[test]
fn given_mutableview_with_reftovec_when_extractingimmutableref() {
    binary_layout!(layout, LittleEndian, {
        field: u8,
        tail: [u8],
    });

    let mut storage = data_region(1024, 0);
    let extracted: Data<&mut Vec<u8>> = {
        let view: layout::View<&mut Vec<u8>> = layout::View::new(&mut storage);
        view.into_tail()
    };

    assert_eq!(&data_region(1024, 0)[1..], &*extracted);
}

#[test]
fn given_mutableview_when_extractingmutableref() {
    binary_layout!(layout, LittleEndian, {
        field: u8,
        tail: [u8],
    });

    let mut storage = data_region(1024, 0);
    let extracted: Data<&mut [u8]> = {
        let view: layout::View<&mut [u8]> = layout::View::new(&mut storage);
        view.into_tail()
    };

    assert_eq!(&data_region(1024, 0)[1..], &*extracted);
}

#[test]
fn given_mutableview_with_reftovec_when_extractingmutableref() {
    binary_layout!(layout, LittleEndian, {
        field: u8,
        tail: [u8],
    });

    let mut storage = data_region(1024, 0);
    let extracted: Data<&mut Vec<u8>> = {
        let view: layout::View<&mut Vec<u8>> = layout::View::new(&mut storage);
        view.into_tail()
    };

    assert_eq!(&data_region(1024, 0)[1..], &*extracted);
}