【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,生成的错误码始终为负数,符合许多系统将负数作为错误码的惯例。

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

相关推荐
点控云25 分钟前
智能私域运营中枢:从客户视角看 SCRM 的体验革新与价值重构
大数据·人工智能·科技·重构·外呼系统·呼叫中心
zkmall2 小时前
企业电商解决方案哪家好?ZKmall模块商城全渠道支持 + 定制化服务更省心
大数据·运维·重构·架构·开源
随缘而动,随遇而安6 小时前
第八十八篇 大数据中的递归算法:从俄罗斯套娃到分布式计算的奇妙之旅
大数据·数据结构·算法
GISer_Jing7 小时前
Git协作开发:feature分支、拉取最新并合并
大数据·git·elasticsearch
IT_10248 小时前
Spring Boot项目开发实战销售管理系统——系统设计!
大数据·spring boot·后端
一只鹿鹿鹿9 小时前
信息化项目验收,软件工程评审和检查表单
大数据·人工智能·后端·智慧城市·软件工程
聚铭网络10 小时前
案例精选 | 某省级税务局AI大数据日志审计中台应用实践
大数据·人工智能·web安全
Qdgr_12 小时前
价值实证:数字化转型标杆案例深度解析
大数据·数据库·人工智能
选择不变12 小时前
日线周线MACD指标使用图文教程,通达信指标
大数据·区块链·通达信指标公式·炒股技巧·短线指标·炒股指标
高山莫衣12 小时前
git rebase多次触发冲突
大数据·git·elasticsearch