ПунктЗначение
ИмяIMPORT-DOC (BIND документа спецификации IMPORT-DOC)
TAG ID0x1E4L
Codec ID0x00001E40
Документ спецификации0x00000000/codecs/0x00001E40/ (цель DECLARE 1E40)
Раздел15 1111 (Meta), смещение в разделе C = 4
KindMeta · класс: IMPORT
TAG WORD0001 1110 0100 LLLL (000K KKKC CCCC LLLL)
Описание в индексеИмпортирует внешний документ под IMPORT ID. Встроенный Reference DOC-POINTER (для документа Codec — CODEC-POINTER) + IMPORT ID
Сторона Hugometa/import/import-doc.md

Поля (документ спецификации)

Порядок FIELD в документе — это порядок полей Payload (Документ спецификации Codec).

ПорядокПоле (BIND)FIELDШиринаПринимаемый формат (CODEC)ENUM
1doc#4запись0410 DOC-POINTER, 0420 CODEC-POINTER
2import-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