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

use binary_layout::prelude::*;

mod common;
use common::data_region;

binary_layout!(sliceonly, LittleEndian, { field: [u8] });

#[test]
fn metadata() {
    assert_eq!(0, sliceonly::field::OFFSET);
    assert_eq!(None, sliceonly::field::SIZE);
}

#[test]
fn fields() {
    let mut storage = data_region(1024, 5);

    // Test initial data is read correctly
    assert_eq!(&data_region(1024, 5), sliceonly::field::data(&storage));

    // Test data can be written
    sliceonly::field::data_mut(&mut storage).copy_from_slice(&data_region(1024, 6));

    // Test reading will return changed data
    assert_eq!(&data_region(1024, 6), sliceonly::field::data(&storage));
}

#[test]
fn view_readonly() {
    let storage = data_region(1024, 5);
    let view = sliceonly::View::new(&storage);

    // Test initial data is read correctly
    assert_eq!(&data_region(1024, 5), view.field());

    // Test into_storage will return correct data
    let extracted_storage: &Vec<u8> = view.into_storage();
    assert_eq!(*extracted_storage, storage);
}

#[test]
fn view_readwrite() {
    let mut storage = data_region(1024, 5);
    let mut view = sliceonly::View::new(&mut storage);

    // Test initial data is read correctly
    assert_eq!(&data_region(1024, 5), view.field());

    // Test data can be written
    view.field_mut().copy_from_slice(&data_region(1024, 6));

    // Test reading will return changed data
    assert_eq!(&data_region(1024, 6), view.field());

    // Test into_storage will return correct data
    let extracted_storage = view.into_storage().to_vec();
    assert_eq!(&storage, &extracted_storage);

    // Test original storage is changed
    assert_eq!(&data_region(1024, 6), &storage);
}

#[test]
fn view_vec_readonly() {
    let view = sliceonly::View::new(data_region(1024, 5));

    // Test initial data is read correctly
    assert_eq!(&data_region(1024, 5), view.field());

    // Test into_storage will return correct data
    let storage: Vec<u8> = view.into_storage();
    assert_eq!(&data_region(1024, 5), &*storage);
}

#[test]
fn view_vec_readwrite() {
    let mut view = sliceonly::View::new(data_region(1024, 5));

    // Test initial data is read correctly
    assert_eq!(&data_region(1024, 5), view.field());

    // Test data can be written
    view.field_mut().copy_from_slice(&data_region(1024, 6));

    // Test reading will return changed data
    assert_eq!(&data_region(1024, 6), view.field());

    // Test into_storage will return correct data
    let extracted_storage = view.into_storage();
    assert_eq!(&data_region(1024, 6), &*extracted_storage);
}