项目值
名称REFERENCE-NODE(规格文档 BIND REFERENCE-NODE)
TAG ID0x0A0L
Codec ID0x00000A00
规格文档0x00000000/codecs/0x00000A00/(DECLARE 目标 0A00)
章节5 0101(Edge 陈述),章节内偏移 C = 0
KindEdge · 系列:陈述,分组:指示与名称
TAG WORD0000 1010 0000 LLLL (000K KKKC CCCC LLLL)
索引说明Reference 形式的 Subject 指示 Object 的有向绑定
Hugo 侧edge/reference-node.md

字段(规格文档)

FIELD 在文档内的顺序就是 Payload 字段顺序(Codec 规格文档)。Edge 的 Edge Id 不用 FIELD 声明。

顺序字段(BIND)FIELD宽度接受的格式(CODEC)ENUM
1subject#2记录任意记录(占位标记除外)
2object#3记录000F 章节 0 全部(通配符,Reference),020F 章节 1 全部(通配符,Reference),040F 章节 2 全部(通配符,Reference),060F 章节 3 全部(通配符,Value),080F 章节 4 全部(通配符,Value)

REFERENCE-NODE 是把一个 Reference 连接到一条 Object 记录,从而定义或绑定该 Reference 是什么的有向陈述 Edge。Codec 0x0A0L。

Subject 指示 Object。这种绑定不是主张语义同一性的 SAME-NODE,也不意味着两条记录的 byte 相同。

布局

TAG WORD          0000 1010 0000 LLLL
[Length 扩展 TAG]
Edge Id           LOCAL Reference 记录
Subject           Reference 记录 1 个
Object            Reference 或 Value 记录 1 个

解释与有效性

  • Subject 必须恰好是一条完整的 Reference 记录。依靠 Subject 自身的 Length 找到边界,不是 Reference 或不完整则为 invalid。
  • Object 必须恰好是一条完整的 Reference 或 Value 记录。依靠 Object 自身的 Length 找到边界,是 Edge、Meta 或不完整则为 invalid。
  • Object 为 Reference 时,沿 REFERENCE-NODE 绑定追溯的 Reference 链不得循环,LOCAL 必须最终得到解析。解析循环和悬空(dangling)LOCAL 为 invalid。
  • 同一文档中,一个 LOCAL ID 被绑定到相互冲突的 Object 则为 invalid。LOCAL 的范围、ID、最小宽度和合并规则遵循 LOCAL。
  • 并非所有 Reference 都必须用 REFERENCE-NODE 绑定。
  • 代表性用法是 LOCAL → UTF8-LANGUAGE-TEXT。当 LABEL 的 Object 放的是 LOCAL 时,用同一文档中的这个绑定解析出文本。

不得把 Subject 指示 Object 的方向反过来解释。SAME 与 DIFFERENT 的含义和细则由各自的格式另行规定。

长度

全部 = 1 + N_len + N_id + N_subject + N_object WORD

N_len 是 Length 扩展 TAG WORD 数,N_id 是 Edge Id LOCAL 记录的 WORD 数,N_subject、N_object 是各记录的总 WORD 数。读完 Subject 和 Object 后的游标必须与 Edge 末尾恰好吻合。

示例(非规范)

Edge Id 为 0008,Subject 为 LOCAL 1,Object 为 Donald Trump(en)的 UTF8-LANGUAGE-TEXT。

  • Edge Id 是 0051 0008,共 2 WORD。
  • Subject 是 0051 0001,共 2 WORD。
  • Object 为语言 0761 656E(BCP47 en)+ 文本 12 byte(偶数),即 UTF8-LANGUAGE-TEXT-EVEN(0x078L),总共 9 WORD。TAG 为 0788。
  • Edge 为 TAG 1 + Edge Id 2 + Subject 2 + Object 9 = 14 WORD,LLLL=1101。TAG 为 0A0D。
0A0D 0051 0008 0051 0001 0788 0761 656E 446F 6E61 6C64 2054 7275 6D70

相关页面

规格文档原文

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

SPEC-VERSION 0x0001
DOC-ID 0x04260000000000000A0000000000
BODY
#1 DECLARE 0x0A00
#2 FIELD #1 record
#3 FIELD #1 record
#4 BIND #1 "REFERENCE-NODE"
#5 BIND #2 "subject"
#6 BIND #3 "object"
#7 CODEC #3 0x000F
#9 CODEC #3 0x020F
#10 CODEC #3 0x040F
#8 CODEC #3 0x060F
#11 CODEC #3 0x080F