| 項目 | 値 |
|---|---|
| 名前 | DOC-POINTER (規格ドキュメント BIND DOC-POINTER) |
| TAG ID | 0x041L |
| Codec ID | 0x00000410 |
| 規格ドキュメント | 0x00000000/codecs/0x00000410/ (DECLARE 対象 0410) |
| セクション | 2 0010 (Reference その他)、セクション内オフセット C = 1 |
| Kind | Reference · 分類: 指示宣言 |
| TAG WORD | 0000 0100 0001 LLLL (000K KKKC CCCC LLLL) |
| Hugo 側 | reference/doc-pointer.md |
フィールド (規格ドキュメント)
FIELD のドキュメント内の順序が Payload のフィールド順だ(Codec 規格ドキュメント)。
| 順序 | フィールド(BIND) | FIELD | 幅 | 受け取る形式(CODEC) | ENUM |
|---|---|---|---|---|---|
| 1 | issuer | #2 | 残り全部の生値(0xFFFF) | ||
| 2 | doc | #3 | 生値 4 WORD | ||
| 3 | version | #4 | 生値 2 WORD |
DOC-POINTER は、Issuer が公表したドキュメントの 1 つのバージョンを指す指示宣言 Reference だ。ドキュメントの公表・deprecate・削除、引用版、ドキュメントについての叙述の対象になる。
レイアウト
TAG WORD 0000 0100 0001 LLLL Codec 0x041L
[Length 拡張 TAG]
Issuer 2/4/16 WORD
ドキュメント ID 4 WORD
バージョン ID 2 WORD
解釈と有効性
- Issuer 幅は、Payload からドキュメント ID とバージョン ID の 6 WORD を除いた残りだ。Codec は幅を分けない。幅が 2、4、16 WORD でない、または Issuer の値がより狭い幅に収まるなら invalid だ(Issuer 正規形)。
- バージョン ID は省略しない。省略を許すと Payload の長さだけでは Issuer 幅を決められない(Issuer 4 WORD・バージョンなしと Issuer 2 WORD・バージョンありが同じ 8 WORD になる)。
- バージョン ID
0は最新バージョンだ。解釈する時点の現行バージョンに結びつく。それ以外の値はそのバージョンに固定される(PUBLICATION)。 - ドキュメント ID
0は Issuer の用語定義索引ドキュメントだ。Issuer 自身は ISSUER-POINTER で指す。 - すべての Issuer は、ドキュメント ID
0x0000000000000000と0xFFFFFFFFFFFFFFFFを予約する(Issuer と公表)。0xFFFFFFFFFFFFFFFFは Issuer0x00000000の Issuer 一覧issuers/に使い、ほかの Issuer は使わない。issuers/versions.geulの PUBLICATION・DEPRECATION・TOMBSTONE がこの値で一覧のバージョンを指す(公表アドレスとバージョン一覧)。 - Codec
0x041L1 つだけだ。量化はない(Identified)。 - Issuer のドキュメントを指す形式は DOC-POINTER 1 つだけだ。
EXTERNAL-ISSUER-*(Issuer、ドキュメント ID、対象 ID0)やEXTERNAL-POINTER-*(IMPORT ID、対象 ID0)でドキュメントを指すのは invalid だ。 - 使われる場所: Meta DOC-ID・IMPORT-DOC、バージョン一覧の PUBLICATION・DEPRECATION・TOMBSTONE。
- Codec ドキュメントにはドキュメント ID がない。Codec ドキュメントとそのバージョンは CODEC-POINTER で指す。
例
GEUL Issuer 0x00000000 のドキュメント 0xFFFF000000000001。
| バージョン | WORD sequence |
|---|---|
| 1 | 0418 0000 0000 FFFF 0000 0000 0001 0000 0001 |
最新 (0) | 0418 0000 0000 FFFF 0000 0000 0001 0000 0000 |
- TAG 1 + Issuer 2 + ドキュメント ID 4 + バージョン ID 2 = 9 WORD、
LLLL=1000だ。TAG は0000 0100 0001 1000=0418だ。
関連ページ
規格ドキュメント原文
規格ドキュメント 0x00000000/codecs/0x00000410/latest.geul を geul show で読んだ様子だ(16進は大文字)。
SPEC-VERSION 0x0001
DOC-ID 0x0426000000000000041000000000
BODY
#1 DECLARE 0x0410
#2 FIELD #1 rest
#3 FIELD #1 0x0004
#4 FIELD #1 0x0002
#5 BIND #1 "DOC-POINTER"
#6 BIND #2 "issuer"
#7 BIND #3 "doc"
#8 BIND #4 "version"