首页
/ libwebsockets JSON 解析器对科学计数法的处理优化

libwebsockets JSON 解析器对科学计数法的处理优化

2025-06-10 01:24:44作者:瞿蔚英Wynne

在 libwebsockets 项目的 JSON 解析器 lejp 中,近期发现了一个关于科学计数法数值解析的问题。当解析如 1e-3 这样的科学计数法表示的数字时,解析器错误地将其识别为整数而非浮点数。

问题背景

JSON 规范支持两种数值表示形式:

  1. 常规整数/浮点数(如 123 或 123.45)
  2. 科学计数法(如 1e3 或 1.23e-4)

在 libwebsockets 4.3.3 版本的 lejp 解析器中,数值类型的判断逻辑存在不足。原代码仅通过检查是否包含小数点(LEJP_SEEN_POINT)来决定是调用整数回调(LEJPCB_VAL_NUM_INT)还是浮点数回调(LEJPCB_VAL_NUM_FLOAT)。

问题分析

这种实现会导致科学计数法表示的数字(如 1e-3)被错误识别为整数,因为:

  1. 1e-3 没有小数点
  2. 但科学计数法本质上表示的是浮点数(1×10⁻³=0.001)

解决方案

正确的做法是,当数值包含以下任一特征时,都应视为浮点数:

  1. 包含小数点(LEJP_SEEN_POINT)
  2. 包含指数标记 e/E(LEJP_SEEN_EXP)

修改后的判断逻辑应该为:

if (ctx->f & (LEJP_SEEN_POINT | LEJP_SEEN_EXP)) {
    // 调用浮点数回调
} else {
    // 调用整数回调
}

技术意义

这个修复确保了 JSON 解析器能正确处理所有合法的 JSON 数值格式,包括:

  • 纯整数(123)
  • 常规浮点数(123.45)
  • 科学计数法整数(1e3)
  • 科学计数法浮点数(1.23e-4 或 1e-3)

对开发者的影响

使用 libwebsockets JSON 解析器的开发者需要注意:

  1. 如果应用中会处理科学计数法表示的数字,建议升级到包含此修复的版本
  2. 在自定义回调函数中,整数和浮点数回调的实现可能需要区分处理
  3. 此修复向后兼容,不会影响现有正确解析的数值

该修复已被合并到项目的主分支和 4.3 稳定分支中,将在下一个正式版本中发布。

登录后查看全文
热门项目推荐
相关项目推荐