EXTERNAL-POINTER — указывающий Reference, указывающий на LOCAL ID документа, подключённого через IMPORT-DOC в HEAD.
| Пункт | Значение |
|---|---|
| Имя | 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 — пять кодов. Квантификация определяется смещением внутри раздела C % 5 (Reference). Документ кодека — по одному на код. Поля у пяти документов кодека одинаковы, различаются только цель 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 — указывающий 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~0x024L | EXTERNAL-POINTER-1WORD | 1 WORD |
0x025L~0x029L | EXTERNAL-POINTER-2WORD | 2 WORD |
0x02AL~0x02EL | EXTERNAL-POINTER-4WORD | 4 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 1 | 0202 0001 0005 |
| LOCAL 65536 для IMPORT ID 1 | 0203 0001 0001 0000 |
| LOCAL 5 для IMPORT ID 70000 | 0253 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).