使用方法

首先向序列化器添加依赖项

例如

[dependencies]
ser-write-json = { version = "0.1", default-features = false }

如果您还想要获取外型类型的 SerWrite 实现，请添加

ser-write = { version = "0.1", default-features = false, features = ["arrayvec", "heapless"] }

在上面的示例中，选择了以下类型的实现：arrayvec::ArrayVec<u8;_> 和 heapless::Vec<u8>。

序列化器

目前可用的序列化和反序列化器有

• JSON (紧凑) - ser-write-json
• MessagePack - ser-write-msgpack

示例

一个 SliceWriter 实现示例

use ser_write::{SerWrite, SerResult, SerError};

#[derive(Debug, PartialEq)]
pub struct SliceWriter<'a> {
    pub buf: &'a mut [u8],
    pub len: usize
}

impl SerWrite for SliceWriter<'_> {
    fn write(&mut self, buf: &[u8]) -> SerResult<()> {
        let end = self.len + buf.len();
        match self.buf.get_mut(self.len..end) {
            Some(chunk) => {
                chunk.copy_from_slice(buf);
                self.len = end;
                Ok(())
            }
            None => Err(SerError::BufferFull)
        }
    }
}

替代方案

仅针对 alloc

• serde_json

或者，有一个 Rust嵌入式社区包用于在不使用 std 的情况下序列化 JSON

• serde-json-core
• serde-json-core-fmt (利用 fmt::Display 特性的尝试式写入器)

serde-json-core 是一个真正的 no_std，没有 alloc 的替代方案，但使用起来不太方便。必须将数据序列化到中间切片中，而不是直接将数据推送到输出缓冲区或帧构建器实现。

为什么这样呢？

• 一旦像 io::Write 这样的功能进入 Rust 核心库，这个包就不再需要了。

Rust 版本要求

ser-write 需要 Rustc 版本 1.75 或更高。