| Пункт | Значение |
|---|---|
| Имя | IMPORT-DOC (BIND документа спецификации IMPORT-DOC) |
| TAG ID | 0x1E4L |
| Codec ID | 0x00001E40 |
| Документ спецификации | 0x00000000/codecs/0x00001E40/ (цель DECLARE 1E40) |
| Раздел | 15 1111 (Meta), смещение в разделе C = 4 |
| Kind | Meta · класс: IMPORT |
| TAG WORD | 0001 1110 0100 LLLL (000K KKKC CCCC LLLL) |
| Описание в индексе | Импортирует внешний документ под IMPORT ID. Встроенный Reference DOC-POINTER (для документа Codec — CODEC-POINTER) + IMPORT ID |
| Сторона Hugo | meta/import/import-doc.md |
Поля (документ спецификации)
Порядок FIELD в документе — это порядок полей Payload (Документ спецификации Codec).
| Порядок | Поле (BIND) | FIELD | Ширина | Принимаемый формат (CODEC) | ENUM |
|---|---|---|---|---|---|
| 1 | doc | #4 | запись | 0410 DOC-POINTER, 0420 CODEC-POINTER | |
| 2 | import-id | #2 | остаток, простое значение (0xFFFF) |
Импортирует внешний документ под IMPORT ID. Импортируемый документ указывает DOC-POINTER, он же несёт ширину Issuer.
Раскладка
TAG WORD 0001 1110 0100 LLLL Codec 0x1E4L
[Length — расширяющий TAG]
Документ запись Reference DOC-POINTER (Issuer, ID документа, ID версии. Если версия 0 — последняя). Для документа Codec — CODEC-POINTER
IMPORT ID всё оставшееся. unsigned наименьшей ширины
- Codec: Meta
0x1E4L, класс IMPORT - Payload: встроенный Reference
DOC-POINTER(Issuer, ID документа, ID версии) + простое значение IMPORT ID - Количество: может быть несколько (по одному на IMPORT ID)
Интерпретация и валидность
- Документ — ровно одна запись DOC-POINTER. При импорте документа Codec — запись CODEC-POINTER (Issuer, Codec ID, ID версии). Она заканчивается своим Length, а остаток — это IMPORT ID.
- IMPORT ID занимает 1 WORD или более, наименьшей ширины. Ширина IMPORT ID здесь определяется длиной записи, а в EXTERNAL-POINTER-* — Codec.
- В одном документе один и тот же IMPORT ID дважды не назначается.
- Если указан ID версии, привязка идёт к этой редакции, если
0— к последней на момент интерпретации (или к действовавшей на указанный момент) редакции (Редакция). - EXTERNAL-POINTER-* в BODY указывает на LOCAL документа, импортированного под IMPORT ID. Сам импортированный документ указывается через DOC-POINTER.
- HEAD импортированного документа не импортируется. Объекты этого документа интерпретируются по его собственным объявлениям.
- По IMPORT ID нельзя искать между документами. Хранилище, загружающее несколько документов, разворачивает IMPORT ID в полный путь (Issuer, ID документа, ID версии, LOCAL ID) и хранит его.
Пример
- IMPORT ID 1, Issuer
0x00000002, документ0x…0002, последняя версия:1E4A 0418 0000 0002 0000 0000 0000 0002 0000 0000 0001(Meta TAG 1 + DOC-POINTER 9 + IMPORT ID 1 = 11 WORD)
Исходный текст документа спецификации
Документ спецификации 0x00000000/codecs/0x00001E40/latest.geul, прочитанный командой geul show (16-ричные значения в верхнем регистре).
SPEC-VERSION 0x0001
DOC-ID 0x04260000000000001E4000000000
BODY
#1 DECLARE 0x1E40
#4 FIELD #1 record
#10 CODEC #4 0x0410
#2 FIELD #1 rest
#6 BIND #1 "IMPORT-DOC"
#7 BIND #2 "import-id"
#9 BIND #4 "doc"
#11 CODEC #4 0x0420