项目值
名称IMPORT-DOC(规格文档 BIND IMPORT-DOC)
TAG ID0x1E4L
Codec ID0x00001E40
规格文档0x00000000/codecs/0x00001E40/(DECLARE 对象 1E40)
章节15 1111(Meta),章节内偏移 C = 4
KindMeta · 类:IMPORT
TAG WORD0001 1110 0100 LLLL(000K KKKC CCCC LLLL)
索引说明以 IMPORT ID 引入外部文档。内置 Reference DOC-POINTER(Codec 文档为 CODEC-POINTER)+ IMPORT ID
Hugo 侧meta/import/import-doc.md

字段(规格文档)

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

顺序字段(BIND)FIELD宽度接收格式(CODEC)ENUM
1doc#4记录0410 DOC-POINTER, 0420 CODEC-POINTER
2import-id#2剩余原始值(0xFFFF)

以 IMPORT ID 引入外部文档。要引入的文档由 DOC-POINTER 指向,Issuer 宽度也由 DOC-POINTER 携带。

布局

TAG WORD          0001 1110 0100 LLLL      Codec 0x1E4L
[Length 扩展 TAG]
文档              DOC-POINTER Reference 记录 (Issuer, 文档 ID, 版本 ID。版本 0 表示最新)。Codec 文档为 CODEC-POINTER
IMPORT ID         其余全部。最短宽度的 unsigned
  • Codec:Meta 0x1E4L,IMPORT 类
  • Payload:内置 Reference DOC-POINTER(Issuer、文档 ID、版本 ID)+ IMPORT ID 原始值
  • 数量:可有多个(每个 IMPORT ID 一个)

解释与有效性

  • 文档恰好是一个 DOC-POINTER 记录。引入 Codec 文档时,则是 CODEC-POINTER(Issuer、Codec ID、版本 ID)记录。它以自身的 Length 结束,其余部分是 IMPORT ID。
  • IMPORT ID 为 1 WORD 以上,取最短宽度。IMPORT ID 的宽度在这里由记录长度决定,在 EXTERNAL-POINTER-* 中由 Codec 决定。
  • 同一文档中不会两次分配相同的 IMPORT ID。
  • 写了版本 ID 则绑定到该版本;为 0 则绑定到解释时点的最新版本(或指定时点正在施行的版本)(修订)。
  • BODY 中的 EXTERNAL-POINTER-* 指向通过 IMPORT ID 引入的文档的 LOCAL。被引入的文档本身用 DOC-POINTER 指向。
  • 不引入被引入文档的 HEAD。该文档的对象按该文档自身的声明来解释。
  • 不能凭 IMPORT ID 跨文档检索。装载多个文档的存储库要把 IMPORT ID 展开为完整路径(Issuer、文档 ID、版本 ID、LOCAL ID)后存储。

示例

  • IMPORT ID 1,Issuer 0x00000002,文档 0x…0002,最新:1E4A 0418 0000 0002 0000 0000 0000 0002 0000 0000 0001(Meta TAG 1 + DOC-POINTER 9 + IMPORT ID 1 = 11 WORD)

规格文档原文

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

SPEC-VERSION 0x0001
DOC-ID 0x04260000000000001E4000000000
BODY
#1 DECLARE 0x1E40
#4 FIELD #1 record
#10 CODEC #4 0x0410
#2 FIELD #1 rest
#6 BIND #1 "IMPORT-DOC"
#7 BIND #2 "import-id"
#9 BIND #4 "doc"
#11 CODEC #4 0x0420