DOC-1WORD、DOC-2WORD、DOC-4WORD 是通过指定文档的总 WORD 数来开启文档的结构 Meta。

项目值
名称DOC-1WORD(规格文档 BIND DOC-1WORD)
TAG ID0x1C0L
Codec ID0x00001C00
规格文档0x00000000/codecs/0x00001C00/(DECLARE 对象 1C00)
章节14 1110(Meta),章节内偏移 C = 0
KindMeta · 类:结构
TAG WORD0001 1100 0000 LLLL(000K KKKC CCCC LLLL)
索引说明在 Payload 的 1 WORD 中指定总长度的文档开头
Hugo 侧meta/structure/doc.md(该侧同时说明 DOC-2WORD、DOC-4WORD)

字段(规格文档)

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

顺序字段(BIND)FIELD宽度接收格式(CODEC)ENUM
1count#2原始值 1 WORD

这是开启文档的记录。在 Payload 中指定文档的总 WORD 数。DOC-1WORD(0x1C0L)、DOC-2WORD(0x1C1L)、DOC-4WORD(0x1C2L)在本页一并说明。

布局

TAG WORD          0001 1100 0000 LLLL      Codec 0x1C0L
[Length 扩展 TAG]
Payload           总 WORD 数。由 Codec 决定宽度:DOC-1WORD 1,DOC-2WORD 2,DOC-4WORD 4
  • Codec:Meta 0x1C0L~0x1C2L,结构类
  • Payload:原始值(文档总 WORD 数,unsigned)
  • 数量:每个文档一个,位于最前

解释与有效性

  • 长度从开启记录的起点算到 END 的末尾。
  • 使用能容纳该值的最窄宽度。以更宽的宽度编码则作为非规范编码拒绝。
  • 长度必须与整个输入相等。一个文档就是一个输入。
  • 解码器可以凭此长度跳过整个文档。不存在不知道长度就开启文档的 Codec。
  • 计算内容哈希时,去掉验证类 Meta 后按相应长度及与之匹配的宽度重新写出(内容哈希)。

示例

  • 0x1C01 0x0017:DOC-1WORD,总计 23 WORD

规格文档原文

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

SPEC-VERSION 0x0001
DOC-ID 0x04260000000000001C0000000000
BODY
#1 DECLARE 0x1C00
#2 FIELD #1 0x0001
#3 BIND #1 "DOC-1WORD"
#4 BIND #2 "count"