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

use binary_layout::prelude::*;
use std::convert::TryInto;

mod common;
use common::data_region;

#[test]
fn test_little_endian() {
    binary_layout!(my_layout, LittleEndian, {
        field1: u16,
        field2: i64,
    });

    let mut storage = data_region(1024, 0);
    let mut view = my_layout::View::new(&mut storage);
    view.field1_mut().write(1000);
    assert_eq!(1000, view.field1().read());
    view.field2_mut().write(10i64.pow(15));
    assert_eq!(10i64.pow(15), view.field2().read());
    assert_eq!(
        1000,
        u16::from_le_bytes((&storage[0..2]).try_into().unwrap())
    );
    assert_eq!(
        10i64.pow(15),
        i64::from_le_bytes((&storage[2..10]).try_into().unwrap())
    );
}

#[test]
fn test_big_endian() {
    binary_layout!(my_layout, BigEndian, {
        field1: u16,
        field2: i64,
    });

    let mut storage = data_region(1024, 0);
    let mut view = my_layout::View::new(&mut storage);
    view.field1_mut().write(1000);
    assert_eq!(1000, view.field1().read());
    view.field2_mut().write(10i64.pow(15));
    assert_eq!(10i64.pow(15), view.field2().read());
    assert_eq!(
        1000,
        u16::from_be_bytes((&storage[0..2]).try_into().unwrap())
    );
    assert_eq!(
        10i64.pow(15),
        i64::from_be_bytes((&storage[2..10]).try_into().unwrap())
    );
}

#[test]
fn test_native_endian() {
    binary_layout!(my_layout, NativeEndian, {
        field1: u16,
        field2: i64,
    });

    let mut storage = data_region(1024, 0);
    let mut view = my_layout::View::new(&mut storage);
    view.field1_mut().write(1000);
    assert_eq!(1000, view.field1().read());
    view.field2_mut().write(10i64.pow(15));
    assert_eq!(10i64.pow(15), view.field2().read());
    assert_eq!(
        1000,
        u16::from_ne_bytes((&storage[0..2]).try_into().unwrap())
    );
    assert_eq!(
        10i64.pow(15),
        i64::from_ne_bytes((&storage[2..10]).try_into().unwrap())
    );
}