Qt 的字节序转换

在 Qt 中，提供了一系列用于字节序转换的函数，类似于 C 标准库中的 htons、htonl、ntohs、ntohl 等，主要用于主机字节序（Host Byte Order）与网络字节序（Network Byte Order，大端字节序）之间的转换。这些函数定义在 <QtEndian> 头文件中，具体如下：

1. 基本转换函数（针对 16/32/64 位整数）

qToBigEndian ：将主机字节序的整数转换为大端字节序（网络字节序）。

重载版本支持 quint16、quint32、quint64 类型，例如：

cpp 复制代码

quint16 host16 = 0x1234;
quint16 net16 = qToBigEndian(host16); // 转换为大端（网络字节序），等效于 htons

quint32 host32 = 0x12345678;
quint32 net32 = qToBigEndian(host32); // 等效于 htonl

qFromBigEndian ：将大端字节序（网络字节序）的整数转换为主机字节序。

重载版本支持 quint16、quint32、quint64 类型，例如：

cpp 复制代码

quint16 net16 = 0x1234;
quint16 host16 = qFromBigEndian(net16); // 转换为主机字节序，等效于 ntohs

quint32 net32 = 0x12345678;
quint32 host32 = qFromBigEndian(net32); // 等效于 ntohl

2. 针对缓冲区的转换（直接操作字节数组）

如果需要将数据直接写入缓冲区（如 QByteArray 或原始字节指针），可以使用以下函数：

qToBigEndian(T value, uchar *buffer) ：将整数 value 以大端字节序写入 buffer。

示例：

cpp 复制代码

quint32 val = 0x12345678;
uchar buf[4];
qToBigEndian(val, buf); // buf 中存储 [0x12, 0x34, 0x56, 0x78]（大端）

qFromBigEndian(const uchar *buffer) ：从缓冲区 buffer 中读取大端字节序的数据，转换为主机字节序。

示例：
cpp 复制代码
```
uchar buf[4] = {0x12, 0x34, 0x56, 0x78};
quint32 val = qFromBigEndian(buf); // val = 0x12345678（主机字节序）
```

3. 小端字节序转换（扩展功能）

Qt 还提供了小端字节序的转换函数（适用于特定场景，如文件格式解析）：

qToLittleEndian：主机字节序 → 小端字节序。
qFromLittleEndian：小端字节序 → 主机字节序。
使用方式与大端函数类似。

注意事项

网络协议（如 TCP/IP）通常使用大端字节序，因此 qToBigEndian 和 qFromBigEndian 是网络编程中最常用的转换函数，分别对应 htons/htonl 和 ntohs/ntohl。
使用前需包含头文件 <QtEndian>。
这些函数是跨平台的，会根据当前主机的字节序（大端或小端）自动处理转换逻辑，无需手动判断主机类型。

总结：Qt 中与 htons/htonl 等效的核心函数是 qToBigEndian，与 ntohs/ntohl 等效的是 qFromBigEndian。