DOC-1WORD, DOC-2WORD и DOC-4WORD — структурные Meta, которые открывают документ, задавая общее число WORD документа.
| Пункт | Значение |
|---|---|
| Имя | DOC-1WORD (BIND документа спецификации DOC-1WORD) |
| TAG ID | 0x1C0L |
| Codec ID | 0x00001C00 |
| Документ спецификации | 0x00000000/codecs/0x00001C00/ (цель DECLARE 1C00) |
| Раздел | 14 1110 (Meta), смещение в разделе C = 0 |
| Kind | Meta · класс: структура |
| TAG WORD | 0001 1100 0000 LLLL (000K KKKC CCCC LLLL) |
| Описание в индексе | начало документа, общая длина которого задана в Payload в 1 WORD |
| Сторона Hugo | meta/structure/doc.md (там также описаны DOC-2WORD, DOC-4WORD) |
Поля (документ спецификации)
Порядок FIELD в документе — это порядок полей Payload (Документ спецификации Codec).
| Порядок | Поле (BIND) | FIELD | Ширина | Принимаемый формат (CODEC) | ENUM |
|---|---|---|---|---|---|
| 1 | count | #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"