EXTERNAL-POINTER は、HEAD の IMPORT-DOC で取り込んだドキュメントの LOCAL ID を指す指示 Reference だ。
| 項目 | 値 |
|---|---|
| 名前 | EXTERNAL-POINTER-4WORD (5Q グループ。コードごとの名前は下のメンバー表) |
| TAG ID | 0x02AL~0x02EL |
| セクション | 1 0001 (Reference EXTERNAL)、セクション内オフセット C = 10~14 |
| Kind | Reference · 分類: 指示 |
| Hugo 側 | reference/external-pointer.md (そのページは EXTERNAL-POINTER-1WORD、EXTERNAL-POINTER-2WORD もまとめて扱う) |
メンバー
このページは 5Q 体系の 1 セット、コード 5 つをまとめて扱う。量化はセクション内オフセット C % 5 だ(Reference)。Codec ドキュメントはコードごとに 1 つある。5 つの Codec ドキュメントはフィールドが同じで、DECLARE 対象と名前(BIND)だけが異なる。
| TAG ID | 名前 | 量化 | Codec ID | 規格ドキュメント | TAG WORD |
|---|---|---|---|---|---|
0x02AL | EXTERNAL-POINTER-4WORD-IDENTIFIED | Identified | 0x000002A0 | 0x00000000/codecs/0x000002A0/ | 0000 0010 1010 LLLL |
0x02BL | EXTERNAL-POINTER-4WORD-GENERIC | Generic | 0x000002B0 | 0x00000000/codecs/0x000002B0/ | 0000 0010 1011 LLLL |
0x02CL | EXTERNAL-POINTER-4WORD-FREE-CHOICE | Free-choice | 0x000002C0 | 0x00000000/codecs/0x000002C0/ | 0000 0010 1100 LLLL |
0x02DL | EXTERNAL-POINTER-4WORD-UNIVERSAL | Universal | 0x000002D0 | 0x00000000/codecs/0x000002D0/ | 0000 0010 1101 LLLL |
0x02EL | EXTERNAL-POINTER-4WORD-VARIABLE | Variable | 0x000002E0 | 0x00000000/codecs/0x000002E0/ | 0000 0010 1110 LLLL |
フィールド (規格ドキュメント)
FIELD のドキュメント内の順序が Payload のフィールド順だ(Codec 規格ドキュメント)。
| 順序 | フィールド(BIND) | FIELD | 幅 | 受け取る形式(CODEC) | ENUM |
|---|---|---|---|---|---|
| 1 | import-id | #2 | 生値 4 WORD | ||
| 2 | target-id | #3 | 残り全部の生値(0xFFFF) |
EXTERNAL-POINTER は、HEAD の IMPORT-DOC で取り込んだドキュメントの LOCAL ID を指す指示 Reference だ。
レイアウト
TAG WORD 0000 001C CCCC LLLL Codec 0x020L~0x02EL (セクション 1)
[Length 拡張 TAG]
IMPORT ID Codec が定める幅 (1/2/4 WORD)
対象 ID 残り全部。取り込んだドキュメントの LOCAL ID、最短幅
| Codec (Identified, Generic, Free-choice, Universal, Variable) | 名前 | IMPORT ID 幅 |
|---|---|---|
0x020L~0x024L | EXTERNAL-POINTER-1WORD | 1 WORD |
0x025L~0x029L | EXTERNAL-POINTER-2WORD | 2 WORD |
0x02AL~0x02EL | EXTERNAL-POINTER-4WORD | 4 WORD |
幅は体系番号で決まる: 体系 − 6(セクション内オフセット
CのC / 5)が 0、1、2 なら 1、2、4 WORD だ。量化はC % 5だ。IMPORT ID の値が収まる最も狭い Codec を使う。
IMPORT ID は、このドキュメントの
IMPORT-DOCが割り当てた値だ。EXTERNAL-POINTER には Issuer を書かない。Issuer とドキュメント ID はそのIMPORT-DOCから得る。バージョンもそのIMPORT-DOCが決める(固定または最新)。取り込んだドキュメントの同じ LOCAL ID なら、そのドキュメント内で LOCAL として書いても、ここで EXTERNAL-POINTER として書いても同じ対象だ。
Variable なら取り込んだドキュメントの LOCAL 変数だ。
有効性
- このドキュメントにその IMPORT ID を割り当てた
IMPORT-DOCがなければ invalid だ。 - IMPORT ID がより狭い Codec に収まるのに広い Codec を使えば、non-minimal として拒否する。
- 対象 ID が
0なら invalid だ。取り込んだドキュメント自身は DOC-POINTER で指す。 - 対象 ID の先頭の
0x0000WORD は禁止する。
例
| 対象 | WORD sequence |
|---|---|
| IMPORT ID 1 の LOCAL 5 | 0202 0001 0005 |
| IMPORT ID 1 の LOCAL 65536 | 0203 0001 0001 0000 |
| IMPORT ID 70000 の LOCAL 5 | 0253 0001 1170 0005 |
関連ページ
規格ドキュメント原文
規格ドキュメント 0x00000000/codecs/0x000002A0/latest.geul を geul show で読んだ様子だ(16進は大文字)。
SPEC-VERSION 0x0001
DOC-ID 0x042600000000000002A000000000
BODY
#1 DECLARE 0x02A0
#2 FIELD #1 0x0004
#3 FIELD #1 rest
#4 BIND #1 "EXTERNAL-POINTER-4WORD-IDENTIFIED"
#5 BIND #2 "import-id"
#6 BIND #3 "target-id"
上は EXTERNAL-POINTER-4WORD-IDENTIFIED(0x02AL)の Codec ドキュメントだ。ほかのメンバー(EXTERNAL-POINTER-4WORD-GENERIC、EXTERNAL-POINTER-4WORD-FREE-CHOICE、EXTERNAL-POINTER-4WORD-UNIVERSAL、EXTERNAL-POINTER-4WORD-VARIABLE)の Codec ドキュメントは、DOC-ID の Codec ID、DECLARE 対象、#1 に結んだ名前(BIND)だけが異なる。