DOC-1WORD, DOC-2WORD и DOC-4WORD — структурные Meta, которые открывают документ, задавая общее число WORD документа.

ПунктЗначение
ИмяDOC-1WORD (BIND документа спецификации DOC-1WORD)
TAG ID0x1C0L
Codec ID0x00001C00
Документ спецификации0x00000000/codecs/0x00001C00/ (цель DECLARE 1C00)
Раздел14 1110 (Meta), смещение в разделе C = 0
KindMeta · класс: структура
TAG WORD0001 1100 0000 LLLL (000K KKKC CCCC LLLL)
Описание в индексеначало документа, общая длина которого задана в Payload в 1 WORD
Сторона Hugometa/structure/doc.md (там также описаны DOC-2WORD, DOC-4WORD)

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

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

ПорядокПоле (BIND)FIELDШиринаПринимаемый формат (CODEC)ENUM
1count#2простое значение 1 WORD

Запись, открывающая документ. В Payload задаётся общее число WORD документа. На этой странице вместе описаны DOC-1WORD (0x1C0L), DOC-2WORD (0x1C1L) и DOC-4WORD (0x1C2L).

Раскладка

TAG WORD          0001 1100 0000 LLLL      Codec 0x1C0L
[Length — расширяющий TAG]
Payload           общее число WORD. Ширину задаёт Codec: DOC-1WORD 1, DOC-2WORD 2, DOC-4WORD 4
  • Codec: Meta 0x1C0L~0x1C2L, класс структуры
  • Payload: простое значение (общее число WORD документа, unsigned)
  • Количество: по одному на документ, в самом начале

Интерпретация и валидность

  • Длина отсчитывается от начала открывающей записи до конца END.
  • Используется самая узкая ширина, в которую помещается значение. Кодирование более широким полем отвергается как неканоническое.
  • Длина должна совпадать с длиной всего входа. Один документ — один вход.
  • По этой длине декодер может пропустить весь документ. Codec, открывающего документ без известной длины, нет.
  • При вычислении хеша содержимого запись переписывается с длиной без Meta класса проверки и с соответствующей ей шириной (Хеш содержимого).

Пример

  • 0x1C01 0x0017: DOC-1WORD, всего 23 WORD

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

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

SPEC-VERSION 0x0001
DOC-ID 0x04260000000000001C0000000000
BODY
#1 DECLARE 0x1C00
#2 FIELD #1 0x0001
#3 BIND #1 "DOC-1WORD"
#4 BIND #2 "count"