ПараметрЗначение
ИмяSIGNED-DECIMAL (документ спецификации BIND SIGNED-DECIMAL)
TAG ID0x068L
Codec ID0x00000680
Документ спецификации0x00000000/codecs/0x00000680/ (цель DECLARE 0680)
Раздел3 0011 (Value), смещение внутри раздела C = 8
KindValue · семейство: DECIMAL
TAG WORD0000 0110 1000 LLLL (000K KKKC CCCC LLLL)
Описание индексаC×10^E со знаковой экспонентой E и coefficient C в дополнительном коде минимальной длины в WORD
На стороне Hugovalue/decimal/signed-decimal.md

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

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

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

SIGNED-DECIMAL — Value, представляющий точное десятичное число (exact decimal) со знаковым coefficient. Прямой код Value 0x068L, семейство DECIMAL. Первые 2 WORD Payload — десятичная экспонента E (signed 32 бита), остальное — coefficient C в дополнительном коде минимальной длины в WORD; значение равно C×10^E.

Раскладка

TAG WORD          0000 0110 1000 LLLL      Codec 0x068L
[Length-расширяющий TAG] если всего 15 WORD и более
Payload WORD 1st–2nd (32 бита)         Signed Base-10 Exponent E
Payload WORD 3rd–Nth (1 WORD и более)  Signed Two's-complement Coefficient C

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

  • E — signed 32-битное целое в дополнительном коде, big-endian, записанное начиная со старшего WORD.
  • C — целое произвольной точности в дополнительном коде, склеенное из всех оставшихся WORD начиная со старшего.
  • C следует тому же правилу минимальной длины в WORD, что и SIGNED-INTEGER. Ведущие WORD 0000 или FFFF, которые можно удалить, запрещены.

Длина и действительность

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

Пример

Представление значенияPayload (E + C)Вердикт
1×10^00000 0000 0001байтовое представление каноничное
10×10^-1FFFF FFFF 000Aбайтовое представление каноничное; canonical-отношение к предыдущему представлению — открытая проблема
1×10^00000 0000 0000 0001неканонично: ведущее 0000 в coefficient лишнее
Payload 7 WORDпрямая длина LLLL=0111, всего 8 WORDканоническая структура длины

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

  • Это расположение, объединяющее signed 32-битную экспоненту E и coefficient C минимальной длины в WORD, — собственный формат GEUL, а не десятичный interchange IEEE 754 и не DECIMAL Apache Parquet.
  • DECIMAL в Parquet использует unscaledValue × 10^(-scale) и обязательные метаданные precision/scale, хранит unscaled value физического типа byte-array как big-endian дополнительный код, а scale неотрицателен. Данный формат помещает signed E в тело и не имеет метаданных precision, поэтому это не тот же формат.
  • Для обмена с десятичными числами IEEE 754 или DECIMAL Parquet нужно явное преобразование, определяющее диапазон, precision/scale, quantum и политику особых значений.
  • Основания для сравнения: IEEE 754-2019, Apache Parquet Logical Types — DECIMAL

Открытые проблемы

  • Существует несколько пар exponent/coefficient, представляющих одно и то же число, например 10×10^-1 и 1×10^0.
  • Сохраняет ли этот формат quantum, как определяется равенство значений и как нормализуется canonical-экспонента — пока не определено.
  • Поэтому реализация не должна произвольно навязывать нормализацию exponent/coefficient сверх правила минимальной длины coefficient в WORD.

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

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

SPEC-VERSION 0x0001
DOC-ID 0x0426000000000000068000000000
BODY
#1 DECLARE 0x0680
#2 FIELD #1 0x0002
#3 FIELD #1 rest
#4 BIND #1 "SIGNED-DECIMAL"
#5 BIND #2 "exponent"
#6 BIND #3 "coefficient"