cisen / sourcecode-byteorder-00

Rust library for reading/writing numbers in big-endian and little-endian.

总结

api 说明

• read_u16深拷贝读取两个字节并返回那两个字节的数据,并且会清空旧的对应内存的数据

use std::io::Cursor;
use byteorder::{BigEndian, ReadBytesExt};
// 默认时u8无符号整型，所以对应的数字时
// [00000010, 00000101, 00000011, 00000000]
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!
// 读取头部的16位则问 0000001000000101 = 2^9 + 2^2 + 2^0 = 512 + 4 + 1 = 517
// 读取完删除已读取的内存
assert_eq!(517, rdr.read_u16::<BigEndian>().unwrap());
// 读取剩下的为： 0000001100000000 = 2^9 + 2^8 = 512 + 256 = 768
assert_eq!(768, rdr.read_u16::<BigEndian>().unwrap());

byteorder

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

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:

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.