#byte #endian #big-endian #little-endian #binary

byteorder

Library for reading/writing numbers in big-endian and little-endian

53 releases (15 stable)

1.3.4 Feb 7, 2020
1.3.2 Jun 9, 2019
1.3.1 Jan 22, 2019
1.2.7 Oct 26, 2018
0.3.3 Mar 25, 2015

#4 in Encoding

Download history 150561/week @ 2019-12-17 97173/week @ 2019-12-24 114461/week @ 2019-12-31 165000/week @ 2020-01-07 165885/week @ 2020-01-14 171649/week @ 2020-01-21 160406/week @ 2020-01-28 191935/week @ 2020-02-04 216524/week @ 2020-02-11 220522/week @ 2020-02-18 234882/week @ 2020-02-25 235034/week @ 2020-03-03 229747/week @ 2020-03-10 235653/week @ 2020-03-17 242058/week @ 2020-03-24 223899/week @ 2020-03-31

660,062 downloads per month
Used in 11,009 crates (1,660 directly)

Unlicense OR MIT

160KB
2K SLoC

This crate provides convenience methods for encoding and decoding numbers in either big-endian or little-endian order.

Build status

Dual-licensed under MIT or the UNLICENSE.

Documentation

https://docs.rs/byteorder

Installation

This crate works with Cargo and is on crates.io. Add it to your Cargo.toml like so:

[dependencies]
byteorder = "1"

If you want to augment existing Read and Write traits, then import the extension methods like so:

extern crate byteorder;

use byteorder::{ReadBytesExt, WriteBytesExt, BigEndian, LittleEndian};

For example:

use std::io::Cursor;
use byteorder::{BigEndian, ReadBytesExt};

let mut rdr = Cursor::new(vec![2, 5, 3, 0]);
// Note that we use type parameters to indicate which kind of byte order
// we want!
assert_eq!(517, rdr.read_u16::<BigEndian>().unwrap());
assert_eq!(768, rdr.read_u16::<BigEndian>().unwrap());

no_std crates

This crate has a feature, std, that is enabled by default. To use this crate in a no_std context, add the following to your Cargo.toml:

[dependencies]
byteorder = { version = "1", default-features = false }

Alternatives

Note that as of Rust 1.32, the standard numeric types provide built-in methods like to_le_bytes and from_le_bytes, which support some of the same use cases.

No runtime deps