IROX-BITS

位与碎片。无std/无分配的流位/字节操作。

此crate提供的主要特质是 Bits（类似于 std::io::Read），以及 MutBits（类似于 std::io::Write）。

还包括多操作系统包装器 SeekRead 和 SeekWrite，以及字符的更自然的UTF-8编码/解码设置。

这是一个IROX基础crate，没有外部依赖，默认为no-std/no-alloc（但可以通过使用std和alloc功能进行增强），并且许多其他irox crate扩展并增强了其中的功能。《irox_structs》是显著的，因为它提供了一种可派生的方式来将结构体编码/解码为字节序列。

无STD支持

• 核心特质 Bits 和 MutBits 以及此crate的多数功能均可在no-std/no-alloc下使用。

特性

• alloc:
  • 启用在alloc包中的类型上实现 Bits 和 MutBits
    • alloc::字符串::字符串
    • alloc::向量::向量
    • alloc::集合::双向队列
  • 启用以下附加方法
    • [Bits::read_u8_blob()] -> Vec<u8>
    • [Bits::read_be_u16_blob()]/[Bits::read_le_u16_blob()] -> Vec<u16>
    • [Bits::read_be_u32_blob()]/[Bits::read_le_u32_blob()] -> Vec<u32>
    • [Bits::read_be_u64_blob()]/[Bits::read_le_u64_blob()] -> Vec<u64>
    • [Bits::read_all_vec()] -> Vec<u8>
    • [Bits::read_exact_vec()] -> Vec<u8>
    • [Bits::read_all_str_lossy()] -> alloc::string::String
    • [Bits::read_str_sized_lossy()] -> alloc::string::String
    • [Bits::read_str_u32_blob()] -> alloc::string::String
    • [Bits::read_until()] -> Vec<u8>
    • [[Bits::consume_until()]] -> ()
    • [[MutBits::write_fmt_impl()]]
• std:
  • 允许在 std 包的类型上实现 Bits 和 MutBits
    • std::fs::文件
  • 同时允许使用 SeekRead 和 SeekWrite 特性，它们封装并规范化
    • std::os::windows::fs::FileExt::seek_read 和 std::os::windows::fs::FileExt::seek_write
    • std::os::unix::fs::FileExt:read_at 和 std::os::unix::fs::FileExt::write_at
  • 允许 std::error::Error 与 BitsError 的兼容性
  • 允许 (几乎) 无缝地在 std::io::Error / BitsError 和 std::io::ErrorKind / BitsErrorKind 之间转换