#endianness #byte #binary

byteordered

Abstraction for reading and writing data with implicit byte order awareness

9 releases (5 breaking)

Uses old Rust 2015

0.6.0 Aug 3, 2021
0.5.0 Dec 2, 2019
0.4.1 Nov 26, 2019
0.4.0 Jan 15, 2019
0.1.0 Nov 22, 2018

#527 in Encoding

Download history 1833/week @ 2023-11-23 1653/week @ 2023-11-30 1949/week @ 2023-12-07 1938/week @ 2023-12-14 1209/week @ 2023-12-21 1062/week @ 2023-12-28 1918/week @ 2024-01-04 1997/week @ 2024-01-11 2133/week @ 2024-01-18 3894/week @ 2024-01-25 16501/week @ 2024-02-01 10501/week @ 2024-02-08 9214/week @ 2024-02-15 11510/week @ 2024-02-22 12479/week @ 2024-02-29 6990/week @ 2024-03-07

41,506 downloads per month
Used in 45 crates (15 directly)

MIT/Apache

77KB
1K SLoC

byteordered

Latest Version CI Status Minimum Rust Version 1.41.1 dependency status

A library for reading and writing data in some byte order.

Why yet another data parsing crate

While byteorder is well established in the Rust ecosystem, it relies on immaterial zero-constructor types for declaring the intended byte order. As such, it lacks a construct for reading and writing data in an endianness that is not originally known at compile time. For example, there are file formats in which the encoding may be either in little endian or in big endian order.

In addition, some users feel that adding the type parameter on each read/write method call is unnecessarily verbose and ugly.

Rather than building yet another new library, this crate aims to provide an alternative public API to byteorder, so that it becomes suitable for this particular case while preserving its familiarity and core capabilities.

Using

An example follows. Please see the documentation for more information.

use byteordered::{ByteOrdered, Endianness};

let mut rd = ByteOrdered::le(get_data_source()?);
// read 1st byte
let b1 = rd.read_u8()?;
// choose to read the following data in Little Endian if it's 0,
// otherwise read in Big Endian
let endianness = Endianness::le_iff(b1 != 0);
let mut rd = rd.into_endianness(endianness);
let value: u32 = rd.read_u32()?;

License

Licensed under either of

at your option.

Unless you explicitly state otherwise, any contribution intentionally submitted for inclusion in the work by you, as defined in the Apache-2.0 license, shall be dual licensed as above, without any additional terms or conditions.

Dependencies

~120KB