项目值
名称SIGNED-INTEGER(规格文档 BIND SIGNED-INTEGER)
TAG ID0x061L
Codec ID0x00000610
规格文档0x00000000/codecs/0x00000610/(DECLARE 目标 0610)
章节3 0011(Value),章节内偏移 C = 1
KindValue · 系列:NUMERIC
TAG WORD0000 0110 0001 LLLL(000K KKKC CCCC LLLL)
索引说明最小 WORD 的二进制补码有符号整数
Hugo 页面value/numeric/signed-integer.md

字段(规格文档)

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

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

SIGNED-INTEGER 是表示有符号整数值的 Value。Value 直接码 0x061L,系列为 NUMERIC。Payload 整体按 big-endian WORD 顺序读作任意精度的二进制补码整数。Payload 至少 1 WORD,且只允许最小 WORD 的规范表示。

布局

TAG WORD          0000 0110 0001 LLLL      Codec 0x061L
[Length 扩展 TAG] 总计 15 WORD 以上时
Payload WORD 1st  (高位 WORD)   Integer 1st
...
Payload WORD Nth  (低位 WORD)   Integer Nth

解释

  • 第一个 Payload WORD 的最高位是整个整数的符号位。
  • 所有 Payload WORD 读作一个连续的二进制补码位串。第一个 WORD 为最高位,最后一个 WORD 为最低位。
  • Payload 为 N WORD 时,解释宽度为 16N bit。该宽度不是声明的存储宽度,而是由规范表示确定的值的表示宽度。
  • 没有 Byte Count 或 bit width descriptor。

规范表示

  • 0 是 Payload 1 WORD 0000。
  • 禁止不改变值的前导符号扩展 WORD。
  • Payload 为 2 WORD 以上时,以下情形为非规范。
    • 第一个 WORD 为 0000,且下一个 WORD 的最高位为 0
    • 第一个 WORD 为 FFFF,且下一个 WORD 的最高位为 1
  • 保持正数符号的前导 0000,在下一个 WORD 的最高位为 1 时允许。
  • 保持负数符号的前导 FFFF,在下一个 WORD 的最高位为 0 时允许。
  • 解码器必须拒绝非规范表示。

长度

  • 总计是 TAG 1 WORD、Length 扩展 TAG(若有)与 Payload 的 WORD 数之和。14 WORD 以下使用直接长度,15 WORD 以上使用 1110·1111 扩展长度,扩展 TAG 也计入总数(记录与 TAG WORD)。
  • 不保留 INT8·INT16·INT32 之类的声明宽度,只保留数值。-32768~32767 为 1 WORD,超出范围则按需增加 WORD。没有单独的 SIGNED-INT8 格式。

示例

值Payload WORD判定
00000规范
10001规范
327677FFF规范
327680000 8000规范:保持正数符号需要 0000
-1FFFF规范
-327688000规范
-32769FFFF 7FFF规范:保持负数符号需要 FFFF
10000 0001非规范:多余的前导 0000
-1FFFF FFFF非规范:多余的前导 FFFF

格式地位

  • 二进制补码是广泛使用的惯例,但把任意精度值规范化为最小 16 位 WORD 序列并与 GEUL TAG 绑定的这种表示,是 GEUL 专有的 scalar profile。
  • 与 INT8/16/32/64 之类的固定宽度外部类型互换时,需要范围检查和显式的宽度转换。

规格文档原文

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

SPEC-VERSION 0x0001
DOC-ID 0x0426000000000000061000000000
BODY
#1 DECLARE 0x0610
#2 FIELD #1 rest
#3 BIND #1 "SIGNED-INTEGER"
#4 BIND #2 "integer"