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

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

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

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

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

Раскладка

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

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

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

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

  • Общая длина — число 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 лишнее
отрицательный coefficientнеприменимоinvalid

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

  • Это расположение, объединяющее signed 32-битную экспоненту E и unsigned coefficient C минимальной длины в WORD, — собственный формат GEUL, а не десятичный interchange IEEE 754 и не DECIMAL Apache Parquet.
  • DECIMAL в Parquet использует signed unscaled value, unscaledValue × 10^(-scale) и обязательные метаданные precision/scale; физический тип byte-array — big-endian дополнительный код, а scale неотрицателен. Данный формат не совпадает с ним из-за unsigned C, 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/0x00000690/latest.geul, прочитанный командой geul show (16-ричные цифры в верхнем регистре).

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