项目值
名称SIGNED-DECIMAL(规格文档 BIND SIGNED-DECIMAL)
TAG ID0x068L
Codec ID0x00000680
规格文档0x00000000/codecs/0x00000680/(DECLARE 目标 0680)
章节3 0011(Value),章节内偏移 C = 8
KindValue · 系列:DECIMAL
TAG WORD0000 0110 1000 LLLL(000K KKKC CCCC LLLL)
索引说明signed exponent E 与最小 WORD 二进制补码 coefficient C 的 C×10^E
Hugo 页面value/decimal/signed-decimal.md

字段(规格文档)

FIELD 在文档中的顺序即 Payload 字段顺序(Codec 规格文档)。

顺序字段(BIND)FIELD宽度接收格式(CODEC)ENUM
1exponent#2原始值 2 WORD
2coefficient#3剩余原始值(0xFFFF)

SIGNED-DECIMAL 是带有符号 coefficient 的精确十进制数(exact decimal)Value。Value 直接码 0x068L,系列为 DECIMAL。Payload 的前 2 WORD 是 signed 32bit 十进制 exponent E,其余是最小 WORD 二进制补码 coefficient C,值为 C×10^E。

布局

TAG WORD          0000 0110 1000 LLLL      Codec 0x068L
[Length 扩展 TAG] 总计 15 WORD 以上时
Payload WORD 1st–2nd (32 位)        Signed Base-10 Exponent E
Payload WORD 3rd–Nth (1 WORD 以上)  Signed Two's-complement Coefficient C

解释

  • E 是自高位 WORD 起记录的 signed 32bit big-endian 二进制补码整数。
  • C 是将其余全部 WORD 自高位 WORD 起连接而成的任意精度二进制补码整数。
  • C 遵循与 SIGNED-INTEGER 相同的最小 WORD 规则。禁止可删除的前导 0000 或 FFFF WORD。

长度与有效性

  • 总计是 TAG 1 WORD、Length 扩展 TAG(若有)与 Payload 的 WORD 数之和。14 WORD 以下使用直接长度,15 WORD 以上使用 1110·1111 扩展长度,扩展 TAG 也计入总数(记录与 TAG WORD)。
  • Payload 由 exponent 2 WORD 与 coefficient 1 WORD 以上组成,因此最少 3 WORD。
  • 字节表示的规范性只检查 coefficient 的最小 WORD 表示。

示例

值表示Payload(E + C)判定
1×10^00000 0000 0001字节表示规范
10×10^-1FFFF FFFF 000A字节表示规范,与上一表示之间的 canonical 关系为未决问题
1×10^00000 0000 0000 0001非规范:coefficient 前导 0000 不必要
Payload 7 WORD直接长度 LLLL=0111,总计 8 WORD规范的长度结构

格式地位

  • 把 signed 32 位 exponent E 与最小 WORD coefficient C 绑定的这种排布,是 GEUL 专有格式,既不是 IEEE 754 decimal interchange,也不是 Apache Parquet DECIMAL。
  • Parquet DECIMAL 使用 unscaledValue × 10^(-scale) 和必需的 precision/scale metadata,以 byte-array 物理类型把 unscaled value 存为 big-endian 二进制补码,scale 为 0 以上。本格式把 signed E 放入正文且没有 precision metadata,因此不是同一种格式。
  • 与 IEEE 754 decimal 或 Parquet DECIMAL 互换时,需要规定范围、precision/scale、quantum、特殊值策略的显式转换。
  • 比较依据:IEEE 754-2019、Apache Parquet Logical Types — DECIMAL

未决问题

  • 像 10×10^-1 与 1×10^0 这样,表示同一个数的 exponent/coefficient 对有多个。
  • 本格式是否保留 quantum、如何判定值相等、如何规范化 canonical exponent,目前尚未规定。
  • 因此实现不得在 coefficient 最小 WORD 规则之外,任意强制 exponent/coefficient 的规范化。

规格文档原文

用 geul show 读取规格文档 0x00000000/codecs/0x00000680/latest.geul 的样子(十六进制为大写)。

SPEC-VERSION 0x0001
DOC-ID 0x0426000000000000068000000000
BODY
#1 DECLARE 0x0680
#2 FIELD #1 0x0002
#3 FIELD #1 rest
#4 BIND #1 "SIGNED-DECIMAL"
#5 BIND #2 "exponent"
#6 BIND #3 "coefficient"