| Elemento | Valor |
|---|---|
| Nombre | UNSIGNED-DECIMAL (documento de especificación BIND UNSIGNED-DECIMAL) |
| TAG ID | 0x069L |
| Codec ID | 0x00000690 |
| Documento de especificación | 0x00000000/codecs/0x00000690/ (destino de DECLARE 0690) |
| Sección | 3 0011 (Value), desplazamiento C dentro de la sección = 9 |
| Kind | Value · familia: DECIMAL |
| TAG WORD | 0000 0110 1001 LLLL (000K KKKC CCCC LLLL) |
| Descripción del índice | C×10^E con un exponent con signo E y un coefficient C unsigned con el mínimo de WORD |
| Lado Hugo | value/decimal/unsigned-decimal.md |
Campos (documento de especificación)
El orden de los FIELD dentro del documento es el orden de los campos del Payload (documento de especificación de Codec).
| Orden | Campo (BIND) | FIELD | Ancho | Formato receptor (CODEC) | ENUM |
|---|---|---|---|---|---|
| 1 | exponent | #2 | valor en bruto, 2 WORD | ||
| 2 | coefficient | #3 | resto en bruto (0xFFFF) |
UNSIGNED-DECIMAL es el Value de decimal exacto (exact decimal) con un coefficient sin signo. Su código directo de Value es 0x069L y su familia es DECIMAL. Los 2 primeros WORD del Payload son el exponent decimal E de 32 bit con signo, el resto es el coefficient C unsigned con el mínimo de WORD, y el valor es C×10^E.
Layout
TAG WORD 0000 0110 1001 LLLL Codec 0x069L
[TAG de extensión de Length] cuando el total es de 15 WORD o más
Payload WORD 1st–2nd (32 bits) Signed Base-10 Exponent E
Payload WORD 3rd–Nth (1 WORD o más) Unsigned Coefficient C
Interpretación
Ees un entero en complemento a dos big-endian con signo de 32 bit, registrado desde el WORD superior.Ces una unsigned magnitude de precisión arbitraria leída desde el WORD superior a lo largo de todos los WORD restantes.Csigue la misma regla de mínimo de WORD que UNSIGNED-INTEGER. El 0 es0000, y con 2 WORD o más se prohíbe que el primer WORD sea0000.
Longitud y validez
- El total es el número de WORD que suman el TAG de 1 WORD, el TAG de extensión de Length (si lo hay) y el Payload. Hasta 14 WORD se usa la longitud directa; desde 15 WORD se usa la longitud extendida
1110·1111, y el TAG de extensión también cuenta en el total (registro y TAG WORD). - El Payload tiene como mínimo 3 WORD, porque son 2 WORD de exponent y 1 WORD o más de coefficient.
- La canonicidad de la representación en bytes solo comprueba la representación con el mínimo de WORD del coefficient.
Ejemplo
| Representación del valor | Payload (E + C) | Veredicto |
|---|---|---|
1×10^0 | 0000 0000 0001 | representación en bytes canónica |
10×10^-1 | FFFF FFFF 000A | representación en bytes canónica; su relación canonical con la anterior es un problema abierto |
1×10^0 | 0000 0000 0000 0001 | no canónico: 0000 inicial del coefficient innecesario |
| coefficient negativo | no aplica | invalid |
Estatus del formato
- Esta disposición, que une un exponent
Ede 32 bit con signo y un coefficientCunsigned con el mínimo de WORD, es un formato propio de GEUL, distinto del decimal de intercambio de IEEE 754 y delDECIMALde Apache Parquet. - El
DECIMALde Parquet usa un unscaled value con signo,unscaledValue × 10^(-scale)y metadatos obligatorios de precision/scale; el tipo físico byte-array es complemento a dos big-endian y el scale es mayor o igual que 0. Este formato no es el mismo porque tieneCunsigned,Econ signo y carece de metadatos de precision. - Para intercambiar datos con el decimal de IEEE 754 o el
DECIMALde Parquet hace falta una conversión explícita que fije el signo, el rango, la precision/scale, el quantum y la política de valores especiales. - Fundamento de la comparación: IEEE 754-2019, Apache Parquet Logical Types — DECIMAL
Problemas abiertos
- Hay varios pares exponent/coefficient que representan el mismo número, como
10×10^-1y1×10^0. - Aún no se ha decidido si este formato conserva el quantum, cómo se juzga la equivalencia de valores ni cómo se normaliza el canonical exponent.
- Por ello, una implementación no debe imponer arbitrariamente una normalización de exponent/coefficient más allá de la regla de mínimo de WORD del coefficient.
Texto original del documento de especificación
Es el aspecto del documento de especificación 0x00000000/codecs/0x00000690/latest.geul leído con geul show (hexadecimal en mayúsculas).
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"