#crc32 #endian #let #food #utf-16 #null-terminated

binwrite

A Rust crate for helping write structs as binary data using ✨macro magic✨

8 releases

0.2.1 Feb 7, 2020
0.2.0 Feb 7, 2020
0.1.5 Dec 11, 2019
0.1.3 Nov 3, 2019

#1435 in Encoding

Download history 803/week @ 2023-10-19 759/week @ 2023-10-26 547/week @ 2023-11-02 475/week @ 2023-11-09 1204/week @ 2023-11-16 412/week @ 2023-11-23 536/week @ 2023-11-30 689/week @ 2023-12-07 730/week @ 2023-12-14 804/week @ 2023-12-21 586/week @ 2023-12-28 903/week @ 2024-01-04 596/week @ 2024-01-11 449/week @ 2024-01-18 570/week @ 2024-01-25 561/week @ 2024-02-01

2,371 downloads per month
Used in 20 crates (13 directly)

MIT license

19KB
225 lines

binwrite

A Rust crate for helping write structs as binary data using ✨macro magic✨

Usage

BinWrite uses a derive macro for declaratively defining binary writing methods for structs.

Basic Example

use binwrite::BinWrite;

#[derive(BinWrite)]
#[binwrite(little)]
struct Rect {
    x: i32,
    y: i32,
    #[binwrite(big)]
    size: (u16, u16),
}

fn main() {
    let rects = vec![
        Rect { x: 1, y: -2, size: (3, 4) },
        Rect { x: 20, y: 4, size: (5, 7) }
    ];
    let mut bytes = vec![];
    rects.write(&mut bytes).unwrap();
    assert_eq!(
        bytes,
        vec![
        //  [  x (little endian) ]  [  y (little endian) ]  [ size.0 ]  [ size.1 ]
            0x01, 0x00, 0x00, 0x00, 0xFE, 0xFF, 0xFF, 0xFF, 0x00, 0x03, 0x00, 0x04,
            0x14, 0x00, 0x00, 0x00, 0x04, 0x00, 0x00, 0x00, 0x00, 0x05, 0x00, 0x07,
        ]
    );
}

more examples can be found in the BinWrite documentation.

Dependencies

~1.5MB
~33K SLoC