Crate byteorder [−] [src]
This crate provides convenience methods for encoding and decoding numbers in either big-endian or little-endian order.
The organization of the crate is pretty simple. A trait, ByteOrder
, specifies
byte conversion methods for each type of number in Rust (sans numbers that have
a platform dependent size like usize
and isize
). Two types, BigEndian
and LittleEndian
implement these methods. Finally, ReadBytesExt
and
WriteBytesExt
provide convenience methods available to all types that
implement Read
and Write
.
Examples
Read unsigned 16 bit big-endian integers from a Read
type:
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());
Write unsigned 16 bit little-endian integers to a Write
type:
use byteorder::{LittleEndian, WriteBytesExt}; let mut wtr = vec![]; wtr.write_u16::<LittleEndian>(517).unwrap(); wtr.write_u16::<LittleEndian>(768).unwrap(); assert_eq!(wtr, vec![5, 2, 0, 3]);
Enums
BigEndian |
Defines big-endian serialization. |
Error |
An error type for reading bytes. |
LittleEndian |
Defines little-endian serialization. |
Traits
ByteOrder |
ByteOrder describes types that can serialize integers as bytes. |
ReadBytesExt |
Extends |
WriteBytesExt |
Extends |
Type Definitions
NativeEndian |
Defines system native-endian serialization. |
Result |
A short-hand for |