| Параметр | Значение |
|---|---|
| Имя | UNSIGNED-DECIMAL (документ спецификации BIND UNSIGNED-DECIMAL) |
| TAG ID | 0x069L |
| Codec ID | 0x00000690 |
| Документ спецификации | 0x00000000/codecs/0x00000690/ (цель DECLARE 0690) |
| Раздел | 3 0011 (Value), смещение внутри раздела C = 9 |
| Kind | Value · семейство: DECIMAL |
| TAG WORD | 0000 0110 1001 LLLL (000K KKKC CCCC LLLL) |
| Описание индекса | C×10^E со знаковой экспонентой E и unsigned coefficient C минимальной длины в WORD |
| На стороне Hugo | value/decimal/unsigned-decimal.md |
Поля (документ спецификации)
Порядок FIELD внутри документа — это порядок полей Payload (документ спецификации Codec).
| Порядок | Поле (BIND) | FIELD | Ширина | Принимаемый формат (CODEC) | ENUM |
|---|---|---|---|---|---|
| 1 | exponent | #2 | простое значение, 2 WORD | ||
| 2 | coefficient | #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 и более первое WORD0000запрещено.
Длина и действительность
- Общая длина — число 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^0 | 0000 0000 0001 | байтовое представление каноничное |
10×10^-1 | FFFF FFFF 000A | байтовое представление каноничное; canonical-отношение к предыдущему представлению — открытая проблема |
1×10^0 | 0000 0000 0000 0001 | неканонично: ведущее 0000 в coefficient лишнее |
| отрицательный coefficient | неприменимо | invalid |
Статус формата
- Это расположение, объединяющее signed 32-битную экспоненту
Eи unsigned coefficientCминимальной длины в WORD, — собственный формат GEUL, а не десятичный interchange IEEE 754 и неDECIMALApache Parquet. DECIMALв Parquet использует signed unscaled value,unscaledValue × 10^(-scale)и обязательные метаданные precision/scale; физический тип byte-array — big-endian дополнительный код, а scale неотрицателен. Данный формат не совпадает с ним из-за unsignedC, signedEи отсутствия метаданных precision.- Для обмена с десятичными числами IEEE 754 или
DECIMALParquet нужно явное преобразование, определяющее знак, диапазон, 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"