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

byteorder

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

47 releases (9 stable)

1.2.6 Aug 25, 2018
1.2.4 Jul 30, 2018
1.2.3 May 12, 2018
1.2.1 Nov 29, 2017
0.3.3 Mar 25, 2015

#5 in Encoding

Download history 48732/week @ 2018-06-03 58870/week @ 2018-06-10 51693/week @ 2018-06-17 52747/week @ 2018-06-24 55168/week @ 2018-07-01 52381/week @ 2018-07-08 56438/week @ 2018-07-15 58205/week @ 2018-07-22 54011/week @ 2018-07-29 67938/week @ 2018-08-05 63484/week @ 2018-08-12 58016/week @ 2018-08-19 57683/week @ 2018-08-26

245,117 downloads per month
Used in 4,953 crates (1,005 directly)

Unlicense/MIT

156KB
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 }

No runtime deps