| Élément | Valeur |
|---|---|
| Nom | SIGNED-DECIMAL (document de spécification BIND SIGNED-DECIMAL) |
| TAG ID | 0x068L |
| Codec ID | 0x00000680 |
| Document de spécification | 0x00000000/codecs/0x00000680/ (cible DECLARE 0680) |
| Section | 3 0011 (Value), offset C dans la section = 8 |
| Kind | Value · famille : DECIMAL |
| TAG WORD | 0000 0110 1000 LLLL (000K KKKC CCCC LLLL) |
| Description d’index | C×10^E avec un signed exponent E et un coefficient C en complément à deux sur un nombre minimal de WORD |
| Côté Hugo | value/decimal/signed-decimal.md |
Champs (document de spécification)
L’ordre des FIELD dans le document est l’ordre des champs du Payload (document de spécification de Codec).
| Ordre | Champ (BIND) | FIELD | Largeur | Format reçu (CODEC) | ENUM |
|---|---|---|---|---|---|
| 1 | exponent | #2 | valeur brute 2 WORD | ||
| 2 | coefficient | #3 | valeur brute restante (0xFFFF) |
SIGNED-DECIMAL est une Value de nombre décimal exact (exact decimal) dont le coefficient est signé. Son code direct Value est 0x068L, sa famille est DECIMAL. Les 2 premiers WORD du Payload sont l’exposant décimal signed 32 bits E, le reste est le coefficient C en complément à deux sur un nombre minimal de WORD, et la valeur est C×10^E.
Disposition
TAG WORD 0000 0110 1000 LLLL Codec 0x068L
[TAG d'extension de Length] à partir de 15 WORD au total
Payload WORD 1st–2nd (32 bits) Signed Base-10 Exponent E
Payload WORD 3rd–Nth (1 WORD ou plus) Signed Two's-complement Coefficient C
Interprétation
Eest un entier signed 32 bits big-endian en complément à deux, enregistré à partir du WORD de poids fort.Cest un entier en complément à deux de précision arbitraire obtenu en mettant bout à bout tous les WORD restants à partir du WORD de poids fort.Csuit la même règle de nombre minimal de WORD que SIGNED-INTEGER. Les WORD0000ouFFFFde tête qui pourraient être supprimés sont interdits.
Longueur et validité
- Le total est le nombre de WORD du TAG (1 WORD), du TAG d’extension de Length (s’il existe) et du Payload. Jusqu’à 14 WORD, on utilise la longueur directe ; à partir de 15 WORD, la longueur étendue
1110·1111, et le TAG d’extension compte aussi dans le total (Enregistrement et TAG WORD). - Le Payload comprend l’exposant de 2 WORD et un coefficient de 1 WORD ou plus ; il fait donc au moins 3 WORD.
- Pour la canonicité de la représentation en octets, on ne vérifie que la représentation à nombre minimal de WORD du coefficient.
Exemple
| Représentation de la valeur | Payload (E + C) | Verdict |
|---|---|---|
1×10^0 | 0000 0000 0001 | représentation en octets canonique |
10×10^-1 | FFFF FFFF 000A | représentation en octets canonique ; sa relation canonique avec la représentation ci-dessus est un problème ouvert |
1×10^0 | 0000 0000 0000 0001 | non canonique : 0000 de tête du coefficient superflu |
| Payload de 7 WORD | longueur directe LLLL=0111, 8 WORD au total | structure de longueur canonique |
Statut de format
- Cette disposition, qui associe un exposant
Esigned 32 bits et un coefficientCà nombre minimal de WORD, est un format propre à GEUL, qui n’est ni l’échange décimal IEEE 754 ni leDECIMALd’Apache Parquet. - Le
DECIMALde Parquet utiliseunscaledValue × 10^(-scale)avec des métadonnées precision/scale obligatoires, stocke la unscaled value du type physique byte-array en complément à deux big-endian, et scale est supérieur ou égal à 0. Le présent format place unEsigned dans le corps et n’a pas de métadonnées de precision ; ce n’est donc pas le même format. - Pour échanger avec l’IEEE 754 decimal ou le
DECIMALde Parquet, une conversion explicite qui fixe l’intervalle, la precision/scale, le quantum et la politique des valeurs spéciales est nécessaire. - Références de comparaison : IEEE 754-2019, Apache Parquet Logical Types — DECIMAL
Problèmes ouverts
- Il existe plusieurs paires exposant/coefficient qui représentent le même nombre, comme
10×10^-1et1×10^0. - On n’a pas encore fixé si ce format conserve le quantum, comment juger l’égalité de valeurs, ni comment normaliser l’exposant canonique.
- Une implémentation ne doit donc pas imposer arbitrairement une normalisation de l’exposant et du coefficient en dehors de la règle du nombre minimal de WORD du coefficient.
Texte source du document de spécification
Voici le document de spécification 0x00000000/codecs/0x00000680/latest.geul tel que lu par geul show (hexadécimal en majuscules).
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"