3个版本
| 0.1.2 | 2021年5月13日 |
|---|---|
| 0.1.1 | 2021年4月17日 |
| 0.1.0 | 2021年4月17日 |
#2269 in 编码
86每月下载量
用于 2 crates
10KB
73 行
eio
读写大端和小端格式的数字。
🚀 入门
将以下内容添加到您的Cargo清单中。
[dependencies]
eio = "0.1"
并将 ReadExt 和/或 WriteExt 特性引入作用域。
use eio::{ReadExt, WriteExt};
🤸 使用
最常用的用法是从源中解析数字。您可以使用实现了 Read 的任何东西上的 read_le() 和 read_be() 方法。
use eio::ReadExt;
// `Cursor` implements `Read`
let mut rdr = std::io::Cursor::new([
0x37, 0x13,
0x12, 0x34, 0x56, 0x78,
0x00, 0x09, 0x10,
]);
// Read a two byte `u16` in little-endian order
let i: u16 = rdr.read_le()?;
assert_eq!(i, 0x1337);
// Read a four byte `i32` in big-endian order
let i: i32 = rdr.read_be()?;
assert_eq!(i, 0x12345678);
// Read a three byte array
let a: [u8; 3] = rdr.read_array()?;
assert_eq!(a, [0x00, 0x09, 0x10]);
数字序列化可以使用 write_le() 和 write_be() 完成。这可以在实现了 Write 的任何东西上完成。
use eio::WriteExt;
// `&mut [u8]` implements `Write`.
let mut wtr = Vec::new();
// Write a four byte `f32` in little-endian order
wtr.write_le(1_f32)?;
// Write a one byte `u8`
wtr.write_be(7_u8)?;
assert_eq!(wtr, &[0, 0, 0x80, 0x3f, 0x07]);
在 no_std 上下文中，可以直接使用 FromBytes 和 ToBytes 特性。
use eio::{FromBytes, ToBytes};
let x: u32 = FromBytes::from_be_bytes([0, 0, 0, 7]);
assert_eq!(x, 7);
let data = ToBytes::to_le_bytes(x);
assert_eq!(data, [7, 0, 0, 0]);
💡 先例
eio 提供了与流行的 byteorder crate 相同的功能，但具有非常不同的 API。 eio 的优点如下
- 它是可扩展的，任何人都可以为他们的自定义整数类型实现
FromBytes或ToBytes。 - 使用 core/std 的
{from,to}_}{le,be}_bytes函数将浮点数和整数进行转换。byteorder重新实现了这些。 - 不需要始终使用turbofish类型注解。
// byteorder let i = rdr.read_u16::<BigEndian>()?; // eio let i: u16 = rdr.read_be()?;
许可证
以下任一许可证下授权
- Apache License，版本 2.0 (LICENSE-APACHE 或 http://www.apache.org/licenses/LICENSE-2.0)
- MIT 许可证 (LICENSE-MIT 或 http://opensource.org/licenses/MIT)
任由您选择。