| Item | Valor |
|---|---|
| Nome | SIGNED-DECIMAL (BIND SIGNED-DECIMAL do documento de especificação) |
| TAG ID | 0x068L |
| Codec ID | 0x00000680 |
| Documento de especificação | 0x00000000/codecs/0x00000680/ (alvo do DECLARE 0680) |
| Seção | 3 0011 (Value), deslocamento C na seção = 8 |
| Kind | Value · família: DECIMAL |
| TAG WORD | 0000 0110 1000 LLLL (000K KKKC CCCC LLLL) |
| Descrição no índice | C×10^E com um signed exponent E e um coefficient C em complemento de dois com o mínimo de WORD |
| Lado Hugo | value/decimal/signed-decimal.md |
Campos (documento de especificação)
A ordem dos FIELD no documento é a ordem dos campos do Payload (documento de especificação do Codec).
| Ordem | Campo (BIND) | FIELD | Largura | Formato recebido (CODEC) | ENUM |
|---|---|---|---|---|---|
| 1 | exponent | #2 | valor bruto de 2 WORD | ||
| 2 | coefficient | #3 | valor bruto restante (0xFFFF) |
SIGNED-DECIMAL é o Value de número decimal exato (exact decimal) com coefficient com sinal. É o direct code de Value 0x068L, família DECIMAL. As 2 primeiras WORD do Payload são o exponent decimal E signed de 32 bits e o restante é o coefficient C em complemento de dois com o mínimo de WORD, e o valor é C×10^E.
Layout
TAG WORD 0000 0110 1000 LLLL Codec 0x068L
[TAG de extensão de Length] quando o total é de 15 WORD ou mais
Payload WORD 1st–2nd (32 bits) Signed Base-10 Exponent E
Payload WORD 3rd–Nth (1 WORD ou mais) Signed Two's-complement Coefficient C
Interpretação
Eé um inteiro em complemento de dois big-endian signed de 32 bits, registrado a partir da WORD superior.Cé um inteiro em complemento de dois de precisão arbitrária formado pela concatenação de todas as WORD restantes, a partir da WORD superior.Csegue a mesma regra de mínimo de WORD de SIGNED-INTEGER. São proibidas as WORD iniciais0000ouFFFFque possam ser removidas.
Comprimento e validade
- O total é o número de WORD somando 1 WORD de TAG, o TAG de extensão de Length (se houver) e o Payload. Até 14 WORD usa-se o comprimento direto; a partir de 15 WORD usa-se o comprimento estendido
1110·1111, e o TAG de extensão também entra no total (Registro e TAG WORD). - O Payload tem 2 WORD de exponent e 1 WORD ou mais de coefficient, portanto no mínimo 3 WORD.
- A canonicidade da representação em bytes verifica apenas a representação de coefficient com o mínimo de WORD.
Exemplo
| Representação do valor | Payload (E + C) | Julgamento |
|---|---|---|
1×10^0 | 0000 0000 0001 | representação em bytes canônica |
10×10^-1 | FFFF FFFF 000A | representação em bytes canônica; a relação canonical com a representação acima é um problema em aberto |
1×10^0 | 0000 0000 0000 0001 | não canônico: 0000 inicial do coefficient desnecessário |
| Payload de 7 WORD | comprimento direto LLLL=0111, total de 8 WORD | estrutura de comprimento canônica |
Status de formato
- Esta disposição, que une o exponent
Esigned de 32 bits ao coefficientCcom o mínimo de WORD, é um formato próprio do GEUL, e não o intercâmbio decimal IEEE 754 nem oDECIMALdo Apache Parquet. - O
DECIMALdo Parquet usaunscaledValue × 10^(-scale)e metadados obrigatórios de precision/scale, guarda o unscaled value do tipo físico byte-array em complemento de dois big-endian, e o scale é maior ou igual a 0. Este formato coloca umEsigned no corpo e não tem metadados de precision, portanto não é o mesmo formato. - Para trocar dados com o decimal IEEE 754 ou com o
DECIMALdo Parquet, é necessária uma conversão explícita que defina intervalo, precision/scale, quantum e a política de valores especiais. - Base de comparação: IEEE 754-2019, Apache Parquet Logical Types — DECIMAL
Problemas em aberto
- Há vários pares exponent/coefficient que representam o mesmo número, como
10×10^-1e1×10^0. - Ainda não se definiu se este formato preserva o quantum, como se julga a igualdade de valores nem como se normaliza o exponent canonical.
- Por isso, uma implementação não deve impor arbitrariamente uma normalização de exponent/coefficient além da regra de mínimo de WORD do coefficient.
Texto original do documento de especificação
É o documento de especificação 0x00000000/codecs/0x00000680/latest.geul lido com geul show (hexadecimal em maiúsculas).
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"