【TDengine源码阅读】TAOS_DEF_ERROR_CODE(mod, code)

2025年5月13日,周二清晨


c 复制代码
#define TAOS_DEF_ERROR_CODE(mod, code) ((int32_t)((0x80000000 | ((mod)<<16) | (code))))

这段代码定义了一个宏 TAOS_DEF_ERROR_CODE(mod, code),用于生成一个32位有符号整数(int32_t)形式的错误码。其核心逻辑是通过位运算将模块标识符(mod)和具体错误码(code)组合成一个唯一的错误码值。以下是逐步解析:

  1. 宏结构

    • 宏名:TAOS_DEF_ERROR_CODE,接受两个参数 mod(模块标识符)和 code(具体错误码)。

    • 最终生成的错误码类型为 int32_t(32位有符号整数)。

  2. 位运算逻辑

    0x80000000:十六进制常量,二进制为 10000000 00000000 00000000 00000000,表示最高位(符号位)为1,确保生成的错误码为负数(通常用于标识错误状态)。

    (mod) << 16:将模块标识符 mod 左移16位,使其占据第16~31位(共16位)。例如,若 mod = 0x01,左移后为 0x00010000

    (code):直接使用 code 的值,占据低16位(第0~15位)。

    • 通过按位或运算 | 将三部分合并:

    错误码 = 0 x 80000000   ∣   ( mod ≪ 16 )   ∣   code \text{错误码} = 0x80000000 \, | \, (\text{mod} \ll 16) \, | \, \text{code} 错误码=0x80000000∣(mod≪16)∣code

  3. 示例

    假设 mod = 0x01code = 0x0A,则:

    0x80000000 | (0x01 << 16) | 0x0A

    • 等价于 0x80000000 | 0x00010000 | 0x0000000A

    • 结果为 0x8001000A(十进制值 -2147416054)。

  4. 应用场景

    • 这种设计常用于系统或库中,通过模块标识符和错误码的组合,快速定位错误来源。例如:

    ◦ 模块A(mod = 0x01)的错误码 0x0A 会被编码为 0x8001000A

    ◦ 模块B(mod = 0x02)的错误码 0x0A 则为 0x8002000A,避免冲突。

  5. 注意事项

    • 参数范围:modcode 需确保在合法范围内(如 mod 不超过16位,code 不超过16位),否则可能导致位溢出。

    • 符号位:最高位固定为1,生成的错误码始终为负数,符合许多系统将负数作为错误码的惯例。

参考类似位操作宏的实现逻辑,这种设计在嵌入式或系统编程中常见,用于高效编码和解码错误信息。

相关推荐
数据与人工智能律师4 小时前
数字迷雾中的安全锚点:解码匿名化与假名化的法律边界与商业价值
大数据·网络·人工智能·云计算·区块链
mykyle6 小时前
Elasticsearch-ik分析器
大数据·elasticsearch·jenkins
weixin_lynhgworld7 小时前
淘宝扭蛋机小程序系统开发:重塑电商互动模式
大数据·小程序
幼儿园老大*9 小时前
数据中心-时序数据库InfluxDB
数据库·时序数据库
RPA+AI十二工作室10 小时前
影刀RPA_Temu关键词取数_源码解读
大数据·自动化·源码·rpa·影刀
Sui_Network10 小时前
探索 Sui 上 BTCfi 的各类资产
大数据·人工智能·科技·游戏·区块链
大数据张老师12 小时前
用 AI 做数据分析:从“数字”里挖“规律”
大数据·人工智能
博闻录13 小时前
以 “有机” 重构增长:云集从电商平台到健康生活社区的跃迁
大数据·重构·生活
nbsaas-boot15 小时前
收银系统优惠功能架构:可扩展设计指南(含可扩展性思路与落地细节)
java·大数据·运维