OPAQUE-BYTES — произвольная последовательность байтов, смысл и формат которой этот формат сам не определяет. Прямой код Value 0x07EL (чётное число байтов) и 0x07FL (нечётное число байтов), семейство BINARY. Число байтов определяется младшим битом Codec и числом Payload WORD: 2 × число Payload WORD − младший бит. Byte Count не вводится (Value).

ПунктЗначение
ИмяOPAQUE-BYTES (группа «чётный/нечётный». Имена по кодам — в таблице участников ниже)
TAG ID0x07EL·0x07FL
Раздел3 0011 (Value), смещение C внутри раздела = 30~31
KindValue · семейство: BINARY
Описание в индексеПоследовательность байтов с неизвестным смыслом и форматом. Чётное и нечётное число байтов
Сторона Hugovalue/binary/opaque-bytes.md

Участники

Эта страница охватывает пару кодов «чётный/нечётный». У чётного кода число байтов чётное, у нечётного — нечётное (запись и TAG WORD). Документ Codec заведён на каждый код. Поля в двух документах Codec совпадают, различаются только цель DECLARE и имя (BIND).

TAG IDИмяЧисло байтовCodec IDДокумент спецификацииTAG WORD
0x07ELOPAQUE-BYTES-EVENчётное0x000007E00x00000000/codecs/0x000007E0/0000 0111 1110 LLLL
0x07FLOPAQUE-BYTES-ODDнечётное0x000007F00x00000000/codecs/0x000007F0/0000 0111 1111 LLLL

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

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

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

Раскладка

TAG WORD          0000 0111 111P LLLL      Codec 0x07EL/0x07FL
[расширяющий Length TAG] если всего 15 WORD и более
Payload WORD 1st ... Nth   байты / последний zero padding

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

  • Из Payload по порядку читается столько byte, сколько указано числом байтов. Внутри WORD старший byte идёт первым.
  • Число Payload WORD равно ceil(число байтов/2). Если код нечётный, а младший byte последнего WORD не равен 00, значение отвергается.
  • Если чётный или нечётный код, число Payload WORD и zero padding не согласуются друг с другом, значение отвергается.

Статус формата

  • Пара кодов «чётный/нечётный» (0x07EL чётный, 0x07FL нечётный), размещение payload и zero padding в последнем WORD — не ссылка на внешний отраслевой стандарт, а собственное обрамление (framing) GEUL.

Длина

  • Всего — число WORD: 1 WORD TAG, расширяющий Length TAG (если есть) и Payload. До 14 WORD используется прямая длина, от 15 WORD — расширенная длина 1110·1111; расширяющий TAG также входит в общее число (запись и TAG WORD).
  • 0 byte записывается как запись в 1 WORD с чётным кодом (0x07EL) (только TAG WORD) (Value).

Пример

byte AB CD EF — 3 byte (нечётное), поэтому OPAQUE-BYTES-ODD (0x07FL), Payload ABCD EF00. Всего 3 WORD, поэтому LLLL=0010.

07F2 ABCD EF00

Пустая последовательность байтов — 1 WORD 07E0 (OPAQUE-BYTES-EVEN, только TAG WORD).

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

Так выглядит документ спецификации 0x00000000/codecs/0x000007E0/latest.geul, прочитанный командой geul show (шестнадцатеричные цифры заглавные).

SPEC-VERSION 0x0001
DOC-ID 0x042600000000000007E000000000
BODY
#1 DECLARE 0x07E0
#2 FIELD #1 rest
#3 BIND #1 "OPAQUE-BYTES-EVEN"
#4 BIND #2 "bytes"

Выше — документ Codec для OPAQUE-BYTES-EVEN (0x07EL). В документах Codec других участников (OPAQUE-BYTES-ODD) различаются только Codec ID в DOC-ID, цель DECLARE и имя, привязанное в #1 (BIND).