项目值
名称GEUL-SIDX(5Q 分组。各代码的名称见下方成员表)
TAG ID0x00FL~0x013L
章节0 0000(Reference 实体),章节内偏移 C = 15~19
KindReference · 分类:声明
Hugo 侧reference/geul-sidx.md

成员

本页合并讲述一套 5Q 体系的五个代码。量化由章节内偏移 C % 5 决定(Reference)。每个代码各有一份 Codec 文档。五份 Codec 文档的字段相同,只有 DECLARE 目标和名称(BIND)不同。

TAG ID名称量化Codec ID规格文档TAG WORD
0x00FLGEUL-SIDX-IDENTIFIEDIdentified0x000000F00x00000000/codecs/0x000000F0/0000 0000 1111 LLLL
0x010LGEUL-SIDX-GENERICGeneric0x000001000x00000000/codecs/0x00000100/0000 0001 0000 LLLL
0x011LGEUL-SIDX-FREE-CHOICEFree-choice0x000001100x00000000/codecs/0x00000110/0000 0001 0001 LLLL
0x012LGEUL-SIDX-UNIVERSALUniversal0x000001200x00000000/codecs/0x00000120/0000 0001 0010 LLLL
0x013LGEUL-SIDX-VARIABLEVariable0x000001300x00000000/codecs/0x00000130/0000 0001 0011 LLLL

字段(规格文档)

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

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

GEUL-SIDX 是用 GEUL SIDX(Semantic-aligned Index)指向对象的声明 Reference。SIDX 是在比特本身承载含义(类别、属性)的标识符。

布局

TAG WORD          0000 0000 1111 LLLL      Codec 0x00FL~0x013L (Identified 0x00FL)
[Length 扩展 TAG]
SIDX              其余全部
  • Quantifier 与其他声明 Codec 相同。为 Variable 时,是该类别的匿名变量(Reference Variable)。量化只通过 5Q 代码(0x00FL~0x013L,C % 5)进行。SIDX 值中不放入量化。
  • 规格文档把 SIDX 声明为一个剩余宽度的原始值字段。宽度规则确定后再修改。

示例

SIDXWORD sequence
(非规范)64 位 0x1234 5678 9ABC DEF0, Identified00F4 1234 5678 9ABC DEF0

分配方针

  • 与 GEUL 的角色不同。GEUL 是大体按顺序(auto increment)分配的身份 ID,GEUL-SIDX 是给语义相近的对象赋予相近值的语义地址。
  • 相近的程度通过积累使用数据,由统计决定。统计积累之前使用 GEUL ID;分配 SIDX 后,用 SAME-NODE 把同一对象的 GEUL 和 GEUL-SIDX 连起来。

未决问题

  • 宽度。 参考统计后决定。正在考虑 4 WORD(64 位)和 16 WORD 等。SIDX 的高位比特有含义,因此不能照搬其他声明 Codec 的“最短宽度”规则(禁止前导 0x0000)。所以会是固定宽度(或按子格式固定宽度)。在确定之前,规格文档把 SIDX 声明为剩余宽度的原始值。
  • 分配的稳定性。 Reference 的整数值相同则为同一对象,且已分配的 ID 不重用。若统计变化后也不想移动已分配的 SIDX,就需要 append-only 分配(为语义相近的位置预留空位的稀疏分配)。若需要经常移动,则要决定是否把 SIDX 定义为与注册表版本绑定的索引,而不是永久标识符。
  • 唯一性。 若 SIDX 按比特语义生成而可能冲突,就与“整数值相同则为同一对象”的前提不符。分配时消解冲突,以保证唯一性。
  • 码本和注册表的公开格式。

相关页面

规格文档原文

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

SPEC-VERSION 0x0001
DOC-ID 0x042600000000000000F000000000
BODY
#1 DECLARE 0x00F0
#2 FIELD #1 rest
#3 BIND #1 "GEUL-SIDX-IDENTIFIED"
#4 BIND #2 "sidx"

以上是 GEUL-SIDX-IDENTIFIED(0x00FL)的 Codec 文档。其他成员(GEUL-SIDX-GENERIC、GEUL-SIDX-FREE-CHOICE、GEUL-SIDX-UNIVERSAL、GEUL-SIDX-VARIABLE)的 Codec 文档,只有 DOC-ID 的 Codec ID、DECLARE 目标、#1 上绑定的名称(BIND)不同。