#serialization #bit-field #struct #pack-unpack

byte_struct

Pack and unpack structure as raw bytes with packed or bit field layout

13 releases (8 breaking)

0.9.0 Mar 18, 2023
0.8.0 Jul 21, 2022
0.7.1 Aug 21, 2021
0.6.1 Mar 2, 2021
0.4.2 Mar 17, 2019

#944 in Encoding

Download history 341/week @ 2024-06-17 133/week @ 2024-06-24 46/week @ 2024-07-01 143/week @ 2024-07-08 49/week @ 2024-07-15 88/week @ 2024-07-22 181/week @ 2024-07-29 175/week @ 2024-08-05 99/week @ 2024-08-12 75/week @ 2024-08-19 136/week @ 2024-08-26 67/week @ 2024-09-02 76/week @ 2024-09-09 89/week @ 2024-09-16 62/week @ 2024-09-23 40/week @ 2024-09-30

273 downloads per month
Used in catnip

MIT/Apache

24KB
357 lines

Byte Struct

Pack and unpack structure as raw bytes with packed or bit field layout.

Example

use byte_struct::*;

bitfields!(
    #[derive(PartialEq, Debug)]
    GIFColorTableInfo: u8 {
        global_color_table_flag: 1,
        color_resolution: 3,
        sort_flag: 1,
        global_color_table_size: 3,
    }
);

#[derive(ByteStruct, PartialEq, Debug)]
#[byte_struct_le]
struct GIFLogicalScreenDescriptor {
    width: u16,
    height: u16,
    color_table_info: GIFColorTableInfo,
    background_color_index: u8,
    pixel_aspect_ratio: u8,
}

fn example() {
    assert_eq!(GIFLogicalScreenDescriptor::BYTE_LEN, 7);
    let raw_descriptor = [0x03, 0x00, 0x05, 0x00, 0xF7, 0x00, 0x00];
    let descriptor = GIFLogicalScreenDescriptor::read_bytes(&raw_descriptor[..]);
    assert_eq!(descriptor, GIFLogicalScreenDescriptor{
        width: 3,
        height: 5,
        color_table_info: GIFColorTableInfo {
            global_color_table_flag: 1,
            color_resolution: 3,
            sort_flag: 1,
            global_color_table_size: 7,
        },
        background_color_index: 0,
        pixel_aspect_ratio: 0,
    });
    let mut raw_another = [0; GIFLogicalScreenDescriptor::BYTE_LEN];
    descriptor.write_bytes(&mut raw_another[..]);
    assert_eq!(raw_descriptor, raw_another);
}

License

Licensed under either of

at your option.

Dependencies

~255–700KB
~17K SLoC