ПараметрЗначение
ИмяSIGNED-INTEGER (документ спецификации BIND SIGNED-INTEGER)
TAG ID0x061L
Codec ID0x00000610
Документ спецификации0x00000000/codecs/0x00000610/ (цель DECLARE 0610)
Раздел3 0011 (Value), смещение внутри раздела C = 1
KindValue · семейство: NUMERIC
TAG WORD0000 0110 0001 LLLL (000K KKKC CCCC LLLL)
Описание индексазнаковое целое в дополнительном коде минимальной длины в WORD
На стороне Hugovalue/numeric/signed-integer.md

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

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

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

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

Раскладка

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

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

  • Старший бит первого WORD Payload — знаковый бит всего целого числа.
  • Все WORD Payload читаются как единая непрерывная битовая строка в дополнительном коде. Первое WORD — самый старший разряд, последнее — самый младший.
  • Если Payload состоит из N WORD, ширина интерпретации равна 16N бит. Эта ширина — не объявленная ширина хранения, а ширина представления значения, определяемая каноническим представлением.
  • Byte Count и descriptor битовой ширины отсутствуют.

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

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

Длина

  • Общая длина — число WORD: TAG 1 WORD, Length-расширяющий TAG (если есть) и Payload. До 14 WORD используется прямая длина, от 15 WORD — расширенная длина 1110·1111, и расширяющий TAG тоже входит в общее число (Запись и TAG WORD).
  • Объявленная ширина вроде INT8·INT16·INT32 не сохраняется, сохраняется только числовое значение. Значения от -32768 до 32767 занимают 1 WORD, а при выходе за этот диапазон добавляется столько WORD, сколько нужно. Отдельного формата SIGNED-INT8 нет.

Пример

ЗначениеPayload WORDВердикт
00000канонично
10001канонично
327677FFFканонично
327680000 8000канонично: для сохранения знака положительного числа нужно 0000
-1FFFFканонично
-327688000канонично
-32769FFFF 7FFFканонично: для сохранения знака отрицательного числа нужно FFFF
10000 0001неканонично: лишнее ведущее 0000
-1FFFF FFFFнеканонично: лишнее ведущее FFFF

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

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

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

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

SPEC-VERSION 0x0001
DOC-ID 0x0426000000000000061000000000
BODY
#1 DECLARE 0x0610
#2 FIELD #1 rest
#3 BIND #1 "SIGNED-INTEGER"
#4 BIND #2 "integer"