flatty

直接映射到Rust类型的扁平消息缓冲区，无需打包/解包。

概述

当类型占用单个连续内存区域时，称为扁平类型。当需要以二进制数据形式存储或发送此类对象，同时又有方便的方式访问其内容而不进行序列化/反序列化时，此类类型非常有用。

此crate提供基本的扁平类型以及创建新的用户定义复合扁平类型的方式（使用#[flat]属性宏），几乎可以像常规Rust struct或enum一样使用。

此外，此crate可以在不使用std甚至alloc的情况下使用。

概念

转换

可以使用as_bytes（和不可安全地as_mut_bytes）从扁平类型的实例获取二进制表示。也可以将字节转换为扁平类型，请参阅原地初始化和验证。

DST

扁平类型可以是动态大小的（如FlatVec），在这种情况下，它利用了Rust操作?Sized类型的能力。用户定义的扁平结构也可以是无大小的（只允许最后一个字段是无大小的）。扁平枚举也可以是无大小的，但Rust尚未原生支持它们，因此其内容只能通过返回包含原始枚举内容引用的常规枚举的as_ref/as_mut方法来访问。

原地初始化

尺寸类型可以作为常规Rust类型实例化。但在DST的情况下，Rust不能以常规方式在堆栈上构造它，因为其大小在编译时是未知的。相反，我们可以在给定的内存区域上初始化此类类型。

为此，我们可以使用所谓的emplacer——一种可以在给定内存上初始化对象的工具。对于尺寸类型，其实例也是emplacer。

emplacer可以应用于原始字节，使用new_in_place，或者使用assign_in_place替换现有结构的内容。另外，一些类型有默认的emplacer，可以通过default_in_place在默认状态下初始化。

验证

并非任何字节的组合都是扁平类型的有效表示。例如，Bool只有两种有效状态：0和1，或者FlatVec的长度不得大于其容量。validate可以用来检查数据是否适用于特定的扁平类型，或者from_bytes/from_mut_bytes也执行此类检查。