ÉlémentValeur
NomSIGNED-DECIMAL (document de spécification BIND SIGNED-DECIMAL)
TAG ID0x068L
Codec ID0x00000680
Document de spécification0x00000000/codecs/0x00000680/ (cible DECLARE 0680)
Section3 0011 (Value), offset C dans la section = 8
KindValue · famille : DECIMAL
TAG WORD0000 0110 1000 LLLL (000K KKKC CCCC LLLL)
Description d’indexC×10^E avec un signed exponent E et un coefficient C en complément à deux sur un nombre minimal de WORD
Côté Hugovalue/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).

OrdreChamp (BIND)FIELDLargeurFormat reçu (CODEC)ENUM
1exponent#2valeur brute 2 WORD
2coefficient#3valeur 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

  • E est un entier signed 32 bits big-endian en complément à deux, enregistré à partir du WORD de poids fort.
  • C est 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.
  • C suit la même règle de nombre minimal de WORD que SIGNED-INTEGER. Les WORD 0000 ou FFFF de 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 valeurPayload (E + C)Verdict
1×10^00000 0000 0001représentation en octets canonique
10×10^-1FFFF FFFF 000Areprésentation en octets canonique ; sa relation canonique avec la représentation ci-dessus est un problème ouvert
1×10^00000 0000 0000 0001non canonique : 0000 de tête du coefficient superflu
Payload de 7 WORDlongueur directe LLLL=0111, 8 WORD au totalstructure de longueur canonique

Statut de format

  • Cette disposition, qui associe un exposant E signed 32 bits et un coefficient C à nombre minimal de WORD, est un format propre à GEUL, qui n’est ni l’échange décimal IEEE 754 ni le DECIMAL d’Apache Parquet.
  • Le DECIMAL de Parquet utilise unscaledValue × 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 un E signed 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 DECIMAL de 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^-1 et 1×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"