EXTERNAL-POINTER は、HEAD の IMPORT-DOC で取り込んだドキュメントの LOCAL ID を指す指示 Reference だ。

項目値
名前EXTERNAL-POINTER-4WORD (5Q グループ。コードごとの名前は下のメンバー表)
TAG ID0x02AL~0x02EL
セクション1 0001 (Reference EXTERNAL)、セクション内オフセット C = 10~14
KindReference · 分類: 指示
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
0x02ALEXTERNAL-POINTER-4WORD-IDENTIFIEDIdentified0x000002A00x00000000/codecs/0x000002A0/0000 0010 1010 LLLL
0x02BLEXTERNAL-POINTER-4WORD-GENERICGeneric0x000002B00x00000000/codecs/0x000002B0/0000 0010 1011 LLLL
0x02CLEXTERNAL-POINTER-4WORD-FREE-CHOICEFree-choice0x000002C00x00000000/codecs/0x000002C0/0000 0010 1100 LLLL
0x02DLEXTERNAL-POINTER-4WORD-UNIVERSALUniversal0x000002D00x00000000/codecs/0x000002D0/0000 0010 1101 LLLL
0x02ELEXTERNAL-POINTER-4WORD-VARIABLEVariable0x000002E00x00000000/codecs/0x000002E0/0000 0010 1110 LLLL

フィールド (規格ドキュメント)

FIELD のドキュメント内の順序が Payload のフィールド順だ(Codec 規格ドキュメント)。

順序フィールド(BIND)FIELD幅受け取る形式(CODEC)ENUM
1import-id#2生値 4 WORD
2target-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~0x024LEXTERNAL-POINTER-1WORD1 WORD
0x025L~0x029LEXTERNAL-POINTER-2WORD2 WORD
0x02AL~0x02ELEXTERNAL-POINTER-4WORD4 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 の先頭の 0x0000 WORD は禁止する。

例

対象WORD sequence
IMPORT ID 1 の LOCAL 50202 0001 0005
IMPORT ID 1 の LOCAL 655360203 0001 0001 0000
IMPORT ID 70000 の LOCAL 50253 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)だけが異なる。