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。

相关推荐
honker_X2 小时前
Python字符串全攻略:从入门到精通
开发语言·python
半杯咖啡半行码2 小时前
Qt 隐式共享(Implicit Sharing)深度解析:机制、陷阱与 Qt6迁移
开发语言·数据库·qt
吃我一窝jio2 小时前
Docker+Jenkins+K8s全流程部署
java·开发语言·笔记·python
eggwyw3 小时前
C++设计模式之解释器模式
开发语言·c++
mengge.cloud5 小时前
Python基础保姆级!从入门到入土
开发语言·python·云原生·pygame
在爪洼山玩泥巴6 小时前
fastjson2 JSONPath 取不存在路径,为什么会抛 “not support”?
java·开发语言·jsonpath·fastjson
星落梦生15 小时前
SpringAOP基础笔记(7)
java·开发语言
曹牧18 小时前
Java:“刷新雪崩”
java·开发语言
郝学胜-神的一滴18 小时前
Effective STL 条款03:容器中的对象复制要廉价且正确
开发语言·数据结构·c++·算法·rpc·stl
西西弗Sisyphus19 小时前
C++ explicit 关键字工程实践
开发语言·c++