大小端转换器

定义

命名空间：

TouchSocket.Core

程序集：

TouchSocket.Core.dll

安装：

dotnet add package TouchSocket.Core

一、基本概念

1. 大小端模式

• 大端模式 (Big Endian)
  高位字节存储在内存低地址，低位字节存储在高地址。
  示例：整数 10 的4字节大端表示为 {0, 0, 0, 10}

• 小端模式 (Little Endian)
  低位字节存储在内存低地址，高位字节存储在高地址。
  示例：整数 10 的4字节小端表示为 {10, 0, 0, 0}

2. 端序类型枚举

TouchSocketBitConverter 支持四种端序类型：

• EndianType.Big - 标准大端
• EndianType.Little - 标准小端
• EndianType.BigSwap - 交换大端（特殊场景）
• EndianType.LittleSwap - 交换小端（特殊场景）

---

二、核心 API 使用

1. 直接指定端序转换器

TouchSocketBitConverter 提供了四个预定义的静态实例，可以直接使用：

• TouchSocketBitConverter.BigEndian - 大端转换器
• TouchSocketBitConverter.LittleEndian - 小端转换器
• TouchSocketBitConverter.BigSwapEndian - 交换大端转换器
• TouchSocketBitConverter.LittleSwapEndian - 交换小端转换器

2. 默认端序配置

🔄 正在加载代码...

---

三、基础数据类型转换

1. 数值类型转换

转换整型 (int)

🔄 正在加载代码...

转换浮点型 (float)

🔄 正在加载代码...

2. 长数据类型处理

转换长整型 (long)

🔄 正在加载代码...

转换高精度小数 (decimal)

🔄 正在加载代码...

---

四、高级功能

1. WriteBytes 写入既有缓冲区

🔄 正在加载代码...

2. 布尔数组转换

TouchSocketBitConverter 支持将布尔数组按位打包到字节数组中，这在处理位标志时非常有用。

🔄 正在加载代码...

3. 批量类型转换

🔄 正在加载代码...

---

五、特殊场景处理

1. 字节序验证

在跨平台开发时，可以通过 IsSameOfSet() 方法检查当前转换器的字节序是否与系统字节序一致。

🔄 正在加载代码...

2. 交换端序模式

TouchSocketBitConverter 提供了 BigSwap 和 LittleSwap 两种交换端序模式，用于处理特殊的数据格式。

🔄 正在加载代码...

3. ToValues 字节批量转换

🔄 正在加载代码...

4. 布尔位打包

🔄 正在加载代码...

5. 跨端批量转换

🔄 正在加载代码...

---

六、注意事项

1. 字节数组长度验证
   所有转换方法会检查数组长度，不足时抛出 ArgumentOutOfRangeException

2. 跨平台兼容性
   建议通过 IsSameOfSet() 验证端序一致性，确保数据在不同平台间正确传输

3. 性能优化

   • 使用 WriteBytes 方法可以直接写入现有缓冲区，避免内存分配
   • 使用 Span<T> 和 ReadOnlySpan<T> 减少内存拷贝
   • 批量转换时使用 ConvertValues 方法提高效率

4. 布尔类型特殊处理
   布尔类型在转换时按位处理，每个布尔值占用1位而不是1字节

---

七、完整示例

1. 网络数据包处理

🔄 正在加载代码...

2. 自定义结构读写

🔄 正在加载代码...

---

八、API 参考

方法	说明
GetBytes<T>(T value)	将值转换为只读内存 ReadOnlyMemory<byte>
To<T>(ReadOnlySpan<byte>)	从字节跨度转换为指定类型的值
WriteBytes<T>(Span<byte>, T)	将值写入字节跨度，返回写入的字节数
ToValues<T>(ReadOnlySpan<byte>)	将字节批量转换为指定类型的数组
ConvertValues<TSource, TTarget>()	在不同类型之间批量转换
GetConvertedLength<TSource, TTarget>()	计算转换后的长度
IsSameOfSet()	检查字节序是否与系统一致