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

ドキュメントを開くレコードである。ドキュメント全体の WORD 数を Payload に指定する。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)
  • 個数: ドキュメントごとに 1 つ、先頭

解釈と有効性

  • 長さは、開くレコードの先頭から END の末尾までである。
  • 値が収まる最も狭い幅を使う。より広い幅でエンコードした場合は非正規エンコードとして拒否する。
  • 長さが入力全体と一致しなければならない。ドキュメント 1 つが入力 1 つである。
  • デコーダはこの長さでドキュメント全体を読み飛ばせる。長さを知らないまま開く Codec はない。
  • コンテンツハッシュを計算するときは、検証クラスの Meta を除いた長さとそれに合う幅で書き直す(コンテンツハッシュ)。

例

  • 0x1C01 0x0017: DOC-1WORD、全体 23 WORD

規格ドキュメント原文

規格ドキュメント 0x00000000/codecs/0x00001C00/latest.geul を geul show で読んだ様子である(16 進は大文字)。

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