#big-endian #little-endian #byte #endian #binary #reader-writer

no-std byteorder_core_io

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

1 unstable release

Uses old Rust 2015

0.5.3 Nov 7, 2016

#2291 in Rust patterns


Used in bincode_core

Unlicense/MIT

39KB
704 lines

This crate provides convenience methods for encoding and decoding numbers in either big-endian or little-endian order. This is meant to replace the old methods defined on the standard library Reader and Writer traits.

Build status

Dual-licensed under MIT or the UNLICENSE.

This fork

This fork uses core_io instead std::io, and is maintained by the Robigalia project (https://robigalia.org/).

Documentation

http://burntsushi.net/rustdoc/byteorder/.

The documentation includes examples.

Installation

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

[dependencies]
byteorder = "0.5"

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 = "0.5", default-features = false }

Dependencies

~45MB
~660K SLoC