| 项目 | 值 |
|---|---|
| 名称 | SIGNED-DECIMAL(规格文档 BIND SIGNED-DECIMAL) |
| TAG ID | 0x068L |
| Codec ID | 0x00000680 |
| 规格文档 | 0x00000000/codecs/0x00000680/(DECLARE 目标 0680) |
| 章节 | 3 0011(Value),章节内偏移 C = 8 |
| Kind | Value · 系列:DECIMAL |
| TAG WORD | 0000 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 |
|---|---|---|---|---|---|
| 1 | exponent | #2 | 原始值 2 WORD | ||
| 2 | coefficient | #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或FFFFWORD。
长度与有效性
- 总计是 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^0 | 0000 0000 0001 | 字节表示规范 |
10×10^-1 | FFFF FFFF 000A | 字节表示规范,与上一表示之间的 canonical 关系为未决问题 |
1×10^0 | 0000 0000 0000 0001 | 非规范:coefficient 前导 0000 不必要 |
| Payload 7 WORD | 直接长度 LLLL=0111,总计 8 WORD | 规范的长度结构 |
格式地位
- 把 signed 32 位 exponent
E与最小 WORD coefficientC绑定的这种排布,是 GEUL 专有格式,既不是 IEEE 754 decimal interchange,也不是 Apache ParquetDECIMAL。 - Parquet
DECIMAL使用unscaledValue × 10^(-scale)和必需的 precision/scale metadata,以 byte-array 物理类型把 unscaled value 存为 big-endian 二进制补码,scale 为 0 以上。本格式把 signedE放入正文且没有 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"