ПараметрЗначение
ИмяUNSIGNED-INTEGER (документ спецификации BIND UNSIGNED-INTEGER)
TAG ID0x062L
Codec ID0x00000620
Документ спецификации0x00000000/codecs/0x00000620/ (цель DECLARE 0620)
Раздел3 0011 (Value), смещение внутри раздела C = 2
KindValue · семейство: NUMERIC
TAG WORD0000 0110 0010 LLLL (000K KKKC CCCC LLLL)
Описание индексацелое число в виде unsigned magnitude big-endian минимальной длины в WORD
На стороне Hugovalue/numeric/unsigned-integer.md

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

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

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

UNSIGNED-INTEGER — Value, представляющий беззнаковое целое число. Прямой код Value 0x062L, семейство NUMERIC. Весь Payload читается как unsigned magnitude произвольной точности с порядком WORD big-endian. Payload занимает минимум 1 WORD, и допускается только каноническое представление минимальной длины в WORD.

Раскладка

TAG WORD          0000 0110 0010 LLLL      Codec 0x062L
[Length-расширяющий TAG] если всего 15 WORD и более
Payload WORD 1st  (старшее WORD)   Unsigned Magnitude 1st
...
Payload WORD Nth  (младшее WORD)   Unsigned Magnitude Nth

Интерпретация

  • Первое WORD Payload — самый старший разряд, последнее WORD — самый младший.
  • Если Payload состоит из N WORD, он читается как единый 16N-битный unsigned magnitude.
  • Эта ширина — не объявленная ширина хранения, и descriptor битовой ширины отсутствует.

Каноническое представление

  • 0 — это Payload из 1 WORD 0000.
  • Если Payload состоит из 2 WORD и более, а первое WORD равно 0000, представление неканонично, так как значение не изменится после его удаления.
  • Декодер обязан отвергать представление с лишними ведущими нулевыми WORD.

Длина

  • Общая длина — число WORD: TAG 1 WORD, Length-расширяющий TAG (если есть) и Payload. До 14 WORD используется прямая длина, от 15 WORD — расширенная длина 1110·1111, и расширяющий TAG тоже входит в общее число (Запись и TAG WORD).
  • Объявленная ширина вроде UINT8·UINT16·UINT32 не сохраняется, сохраняется только числовое значение.

Пример

ЗначениеPayload WORDВердикт
00000канонично
10001канонично
65535FFFFканонично
655360001 0000канонично
10000 0001неканонично: лишнее ведущее 0000
Payload из 7 WORD7 WORD после TAG 0627 (прямая длина LLLL=0111, всего 8 WORD)канонично
Payload из 7 WORD7 WORD после Length-расширяющего TAG и расширенного значения 0009неканонично: до 14 WORD используется прямая длина

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

  • Это представление, нормализующее unsigned magnitude произвольной точности в последовательность 16-битных WORD минимальной длины и объединяющее её с TAG GEUL, — собственный scalar profile GEUL.
  • При обмене с внешними типами фиксированной ширины, такими как UINT8/16/32/64, требуются проверка диапазона и явное преобразование ширины.

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

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

SPEC-VERSION 0x0001
DOC-ID 0x0426000000000000062000000000
BODY
#1 DECLARE 0x0620
#2 FIELD #1 rest
#3 BIND #1 "UNSIGNED-INTEGER"
#4 BIND #2 "magnitude"