ПунктЗначение
ИмяFIELD (BIND документа спецификации FIELD)
TAG ID0x0BCL
Codec ID0x00000BC0
Документ спецификации0x00000000/codecs/0x00000BC0/ (цель DECLARE 0BC0)
Раздел5 0101 (Edge-высказывание), смещение C внутри раздела = 28
KindEdge · семейство: высказывание, группа: прочее
TAG WORD0000 1011 1100 LLLL (000K KKKC CCCC LLLL)
Описание в индексеОдно поле Payload. Принадлежащий ему DECLARE, ширина: запись (Length из TAG) либо простое значение n WORD
Сторона Hugoedge/field.md

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

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

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

FIELD — Edge-высказывание, объявляющий одно поле Payload Codec. Codec 0x0BCL.

FIELD указывает на свой DECLARE. FIELD, указывающие на один DECLARE, образуют Payload в порядке их расположения в документе. Раскладка встроена в декодер (документ спецификации Codec).

Раскладка

TAG WORD          0000 1011 1100 LLLL
Edge Id           запись LOCAL Reference
DECLARE           запись LOCAL Reference. Edge DECLARE, которому принадлежит это поле
ширина            1 WORD. 0 = запись, n (1~65534) = простое значение n WORD, 0xFFFF = остаток простого значения

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

  • DECLARE указывает на Edge DECLARE в том же документе. Один FIELD принадлежит только одному DECLARE. Порядок отдельно не записывается: это порядок расположения записей FIELD в документе.
  • Документ спецификации FIELD объявляет DECLARE как поле с шириной 0 (запись) и CODEC 0050 (LOCAL). Поэтому в графе средства просмотра связь FIELD → DECLARE рисуется как соединение.
  • Ширина 0 — поле-запись. Оно начинается с TAG WORD и читается на Length этого TAG (правила интерпретации DECLARE).
  • Ширина n (1~65534) — поле простого значения. Всегда ровно n WORD.
  • Ширина 0xFFFF — остаток простого значения. В DECLARE он один и может стоять в начале, в середине или в конце. Ширина — это оставшиеся WORD, заданные TAG Length внешней записи, за вычетом ширины следующих полей. Поэтому все поля после поля-остатка должны быть простыми значениями фиксированной ширины (запись можно прочесть только с начала, чтобы узнать её конец). Может быть 0 WORD. ENUM не прикрепляется.
  • Принимаемые полем Kind·Codec указываются через CODEC. Если у поля-записи нет CODEC, оно принимает любую запись, если есть — запись должна быть одной из них. Если у поля простого значения задан один CODEC, это простое значение интерпретируется как соответствующее Value без TAG.
  • Имя поля привязывается к Edge Id FIELD через BIND (например, doc, hash). UTF8-TEXT, прикрепляемые к DECLARE, FIELD, ENUM и CODEC, все задаются через BIND и не прикрепляются другими Edge, например LABEL.
  • Смысл кодовых значений поля простого значения прикрепляется через ENUM.
  • Поле, указывающее в графе на другой узел, отдельно не отмечается. Если поле-запись — Reference, это и есть связь.

Длина

всего = 1 + 2 + 2 + 1 WORD   (когда Edge Id и DECLARE — LOCAL с ID в 1 WORD)

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

  • Поле-запись: Edge Id 7, DECLARE #1, ширина 0. TAG 1 + Edge Id 2 + DECLARE 2 + ширина 1 = 6 WORD. Чтобы принимался только LOCAL, смотрите пример CODEC.
0BC5 0051 0007 0051 0001 0000
  • Поле простого значения вроде хеша содержимого — смотрите пример DECLARE.

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

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

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

SPEC-VERSION 0x0001
DOC-ID 0x04260000000000000BC000000000
BODY
#1 DECLARE 0x0BC0
#2 FIELD #1 record
#13 CODEC #2 0x0050
#3 FIELD #1 0x0001
#5 ENUM #3 0x0000
#6 ENUM #3 0xFFFF
#7 BIND #1 "FIELD"
#8 BIND #2 "declare"
#9 BIND #3 "width"
#11 BIND #5 "record"
#12 BIND #6 "rest"