#endian #endianness #binary #little-endian #big-endian

endiannezz

Zero dependencies library for I/O endianness on high-level

17 releases

0.6.5 Jul 26, 2021
0.6.3 Feb 28, 2021
0.6.0 Nov 28, 2020
0.4.1 Jun 13, 2020

#628 in Encoding

Download history 52/week @ 2023-06-04 42/week @ 2023-06-11 76/week @ 2023-06-18 53/week @ 2023-06-25 44/week @ 2023-07-02 45/week @ 2023-07-09 13/week @ 2023-07-16 47/week @ 2023-07-23 39/week @ 2023-07-30 9/week @ 2023-08-06 43/week @ 2023-08-13 14/week @ 2023-08-20 29/week @ 2023-08-27 60/week @ 2023-09-03 15/week @ 2023-09-10 40/week @ 2023-09-17

144 downloads per month
Used in theory

MIT license

16KB
202 lines

endiannezz

Build Status Latest Version Documentation

Zero dependencies library for I/O endianness on high-level

Installing

[dependencies]
endiannezz = "0.6"

Using #[derive(Io)]

use endiannezz::Io;
use std::io::Result;

#[derive(Io)]
#[endian(big)]
struct ParseMe {
    works: bool,
    data: u32,
    #[endian(little)]
    extra: i16,
}

fn main() -> Result<()> {
    let s1 = ParseMe {
        works: true,
        data: 10,
        extra: 20,
    };

    //writing struct as bytes into vec
    let mut vec = Vec::new();
    s1.write(&mut vec)?;

    let mut slice = vec.as_slice();
    #[rustfmt::skip]
    assert_eq!(slice, &[
        1, //bool as byte
        0, 0, 0, 10, //u32 in big-endian (because big-endian is set on top place struct as default)
        20, 0, //i16 in little-endian (overriding default)
    ]);

    //reading struct from bytes
    let _s2 = ParseMe::read(&mut slice)?;

    Ok(())
}

Simple example

use endiannezz::ext::{EndianReader, EndianWriter};
use endiannezz::{BigEndian, LittleEndian, NativeEndian};
use std::io::Result;

fn main() -> Result<()> {
    let mut vec = Vec::new();

    vec.try_write::<LittleEndian, i32>(1)?;
    vec.try_write::<BigEndian, _>(2)?;
    vec.try_write::<NativeEndian, _>(3_u16)?;

    let mut slice = vec.as_slice();

    slice.try_read::<LittleEndian, i32>()?;
    let _num32: i32 = slice.try_read::<BigEndian, _>()?;
    let _num16: u16 = slice.try_read::<NativeEndian, _>()?;

    Ok(())
}

Dependencies

~190KB