| commit | f863c9eda89b5e2aa72d650991b815f9c960ed52 | [log] [tgz] |
|---|---|---|
| author | Andrew Gallant <jamslam@gmail.com> | Sat May 21 09:53:57 2016 -0400 |
| committer | Andrew Gallant <jamslam@gmail.com> | Sat May 21 09:53:57 2016 -0400 |
| tree | 0cf02fde5b5ba58ba948a95e656340f387d2c91b | |
| parent | d17987c1748d81472eb15204f269bccec75adab1 [diff] |
Fixes undefined behavior reported in #47. Instead of casting pointers, we do a proper unaligned load using copy_nonoverlapping. Benchmarks appear unaffected on Linux x64.
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.
Dual-licensed under MIT or the UNLICENSE.
http://burntsushi.net/rustdoc/byteorder/.
The documentation includes examples.
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 cratesThis 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 }