ПунктЗначение
ИмяENUM (BIND документа спецификации ENUM)
TAG ID0x0BDL
Codec ID0x00000BD0
Документ спецификации0x00000000/codecs/0x00000BD0/ (цель DECLARE 0BD0)
Раздел5 0101 (Edge-высказывание), смещение C внутри раздела = 29
KindEdge · семейство: высказывание, группа: прочее
TAG WORD0000 1011 1101 LLLL (000K KKKC CCCC LLLL)
Описание в индексеОдно кодовое значение поля простого значения. Поле, кодовое значение
Сторона Hugoedge/enum.md

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

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

ПорядокПоле (BIND)FIELDШиринаПринимаемый формат (CODEC)ENUM
1field#2запись0050 LOCAL
2code#3остаток простого значения (0xFFFF)

ENUM — Edge-высказывание, придающий смысл одному кодовому значению поля простого значения. Codec 0x0BDL.

Вместе с FIELD это словарь для записи спецификации Codec. Раскладка встроена в декодер (документ спецификации Codec).

Раскладка

TAG WORD          0000 1011 1101 LLLL
[Length, расширяющий TAG]
Edge Id           запись LOCAL Reference
поле              запись LOCAL Reference, указывающая на Edge FIELD
кодовое значение  простое значение. Столько же WORD, сколько ширина этого FIELD

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

  • Поле должно быть FIELD простого значения (ширина n ≥ 1). К полю-записи ENUM не прикрепляется. Смысл записи говорит Codec этой записи.
  • Кодовое значение занимает ровно ширину этого FIELD. Граница проверяется по Length записи ENUM.
  • В одном поле одно и то же кодовое значение дважды не объявляют.
  • Имя кодового значения привязывается к Edge Id ENUM через BIND. UTF8-TEXT, прикрепляемые к DECLARE, FIELD, ENUM и CODEC, все задаются через BIND и не прикрепляются другими Edge, например LABEL.
  • Необъявленное кодовое значение не является ошибкой. Средство просмотра показывает простое значение как есть. Закрывать ли допустимые значения, решает спецификация Codec; в нынешнем словаре отметки закрытия нет.

Длина

всего = 1 + N_len + N_id + N_field + n WORD

Пример (не нормативно)

Для поля категории причины в документе спецификации TOMBSTONE (FIELD #4, простое значение 1 WORD) объявляется код 0x0001. Edge Id 10. Имя привязывается отдельно через BIND. Таблица кодов категорий причин ещё не определена, поэтому кодовое значение — лишь пример.

  • TAG 1 + Edge Id 2 + поле 2 + кодовое значение 1 = 6 WORD, LLLL = 0101.
0BD5 0051 000A 0051 0004 0001

В документе спецификации TRIPLE у поля Rank (FIELD #5) три ENUM (0·1·2), которые через BIND получают имена normal·preferred·deprecated (TRIPLE).

Связанные страницы

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

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

SPEC-VERSION 0x0001
DOC-ID 0x04260000000000000BD000000000
BODY
#1 DECLARE 0x0BD0
#2 FIELD #1 record
#3 FIELD #1 rest
#4 BIND #1 "ENUM"
#5 BIND #2 "field"
#6 BIND #3 "code"
#7 CODEC #2 0x0050