EXTERNAL-POINTER — указывающий Reference, указывающий на LOCAL ID документа, подключённого через IMPORT-DOC в HEAD.

ПунктЗначение
ИмяEXTERNAL-POINTER-4WORD (группа 5Q; имена по кодам — в таблице членов ниже)
TAG ID0x02AL~0x02EL
Раздел1 0001 (Reference EXTERNAL), смещение внутри раздела C = 10~14
KindReference · классификация: указание
Сторона Hugoreference/external-pointer.md (эта страница охватывает также EXTERNAL-POINTER-1WORD и EXTERNAL-POINTER-2WORD)

Члены

Эта страница охватывает один комплект системы 5Q — пять кодов. Квантификация определяется смещением внутри раздела C % 5 (Reference). Документ кодека — по одному на код. Поля у пяти документов кодека одинаковы, различаются только цель 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 — указывающий Reference, указывающий на LOCAL ID документа, подключённого через IMPORT-DOC в HEAD.

Раскладка

TAG WORD          0000 001C CCCC LLLL      Codec 0x020L~0x02EL (раздел 1)
[расширяющий TAG Length]
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 / 5 от смещения внутри раздела C) равна 0, 1, 2, то ширина 1, 2, 4 WORD. Квантификация — C % 5.

  • Используют самый узкий Codec, в который помещается значение IMPORT ID.

  • IMPORT ID — значение, назначенное IMPORT-DOC этого документа. В EXTERNAL-POINTER Issuer не записывают. Issuer и ID документа берут из этого IMPORT-DOC. Версию тоже определяет этот IMPORT-DOC (фиксированная или последняя).

  • Один и тот же LOCAL ID подключённого документа — одна и та же цель, независимо от того, записан ли он как LOCAL внутри того документа или как EXTERNAL-POINTER здесь.

  • Для Variable это LOCAL-переменная подключённого документа.

Действительность

  • Если в этом документе нет IMPORT-DOC, назначившего данный IMPORT ID, это invalid.
  • Если IMPORT ID помещается в более узкий Codec, а использован более широкий, это отвергается как non-minimal.
  • Если ID цели равен 0, это invalid. На сам подключённый документ указывают через DOC-POINTER.
  • Ведущий WORD 0x0000 в ID цели запрещён.

Пример

ЦельWORD sequence
LOCAL 5 для IMPORT ID 10202 0001 0005
LOCAL 65536 для IMPORT ID 10203 0001 0001 0000
LOCAL 5 для IMPORT ID 700000253 0001 1170 0005

Связанные страницы

Исходный текст документа спецификации

Документ спецификации 0x00000000/codecs/0x000002A0/latest.geul, прочитанный командой geul show (шестнадцатеричные значения в верхнем регистре).

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). У остальных членов (EXTERNAL-POINTER-4WORD-GENERIC, EXTERNAL-POINTER-4WORD-FREE-CHOICE, EXTERNAL-POINTER-4WORD-UNIVERSAL, EXTERNAL-POINTER-4WORD-VARIABLE) в документе кодека различаются только Codec ID в DOC-ID, цель DECLARE и имя, привязанное в #1 (BIND).