| Eintrag | Wert |
|---|---|
| Name | SIGNED-DECIMAL (Spezifikationsdokument BIND SIGNED-DECIMAL) |
| TAG ID | 0x068L |
| Codec ID | 0x00000680 |
| Spezifikationsdokument | 0x00000000/codecs/0x00000680/ (DECLARE-Ziel 0680) |
| Abschnitt | 3 0011 (Value), Offset C im Abschnitt = 8 |
| Kind | Value · Familie: DECIMAL |
| TAG WORD | 0000 0110 1000 LLLL (000K KKKC CCCC LLLL) |
| Index-Beschreibung | C×10^E aus vorzeichenbehaftetem Exponenten E und Zweierkomplement-coefficient C mit minimaler WORD-Anzahl |
| Hugo-Seite | value/decimal/signed-decimal.md |
Felder (Spezifikationsdokument)
Die Reihenfolge der FIELD im Dokument ist die Reihenfolge der Payload-Felder (Codec-Spezifikationsdokument).
| Nr. | Feld (BIND) | FIELD | Breite | Zielformat (CODEC) | ENUM |
|---|---|---|---|---|---|
| 1 | exponent | #2 | Rohwert 2 WORD | ||
| 2 | coefficient | #3 | restlicher Rohwert (0xFFFF) |
SIGNED-DECIMAL ist ein Value für eine exakte Dezimalzahl (exact decimal) mit vorzeichenbehaftetem coefficient. Direkter Value-Code 0x068L, Familie DECIMAL. Die ersten 2 WORD des Payload sind der 32-Bit-Dezimalexponent E mit Vorzeichen, der Rest ist der Zweierkomplement-coefficient C mit minimaler WORD-Anzahl, und der Wert ist C×10^E.
Layout
TAG WORD 0000 0110 1000 LLLL Codec 0x068L
[Length-Erweiterungs-TAG] bei insgesamt 15 WORD oder mehr
Payload WORD 1st–2nd (32 Bit) Signed Base-10 Exponent E
Payload WORD 3rd–Nth (ab 1 WORD) Signed Two's-complement Coefficient C
Interpretation
Eist eine vorzeichenbehaftete 32-Bit-big-endian-Zweierkomplement-Ganzzahl, beginnend mit dem oberen WORD.Cist eine Zweierkomplement-Ganzzahl beliebiger Genauigkeit, die durch Aneinanderfügen aller übrigen WORD, beginnend mit dem oberen WORD, entsteht.Cfolgt derselben Regel der minimalen WORD-Anzahl wie SIGNED-INTEGER. Führende0000- oderFFFF-WORD, die gelöscht werden könnten, sind verboten.
Länge und Gültigkeit
- Die Gesamtzahl ist die Summe der WORD aus 1 WORD TAG, dem Length-Erweiterungs-TAG (falls vorhanden) und dem Payload. Bis 14 WORD wird die direkte Länge verwendet, ab 15 WORD die erweiterte Länge
1110·1111, und auch der Erweiterungs-TAG zählt zur Gesamtzahl (Record und TAG WORD). - Der Payload besteht aus 2 WORD Exponent und mindestens 1 WORD coefficient, hat also mindestens 3 WORD.
- Die Kanonizität der Byte-Darstellung prüft nur die Darstellung des coefficient mit minimaler WORD-Anzahl.
Beispiel
| Wertdarstellung | Payload (E + C) | Beurteilung |
|---|---|---|
1×10^0 | 0000 0000 0001 | Byte-Darstellung kanonisch |
10×10^-1 | FFFF FFFF 000A | Byte-Darstellung kanonisch, die Canonical-Beziehung zur obigen Darstellung ist ein offenes Problem |
1×10^0 | 0000 0000 0000 0001 | nicht kanonisch: führendes 0000 im coefficient überflüssig |
| Payload 7 WORD | direkte Länge LLLL=0111, insgesamt 8 WORD | kanonische Längenstruktur |
Formatstatus
- Diese Anordnung, die einen 32-Bit-Exponenten
Emit Vorzeichen und einen coefficientCmit minimaler WORD-Anzahl verbindet, ist ein GEUL-eigenes Format und weder IEEE-754-Decimal-Interchange noch Apache ParquetDECIMAL. - Parquet
DECIMALverwendetunscaledValue × 10^(-scale)sowie die obligatorischen Metadaten precision/scale, speichert den unscaled value des Byte-Array-Typs als big-endian Zweierkomplement, und scale ist mindestens 0. Dieses Format legt ein vorzeichenbehaftetesEin den Datenteil und hat keine precision-Metadaten, ist also nicht dasselbe Format. - Für den Austausch mit IEEE-754-Decimal oder Parquet
DECIMAList eine explizite Konvertierung nötig, die Bereich, precision/scale, quantum und die Richtlinie für Sonderwerte festlegt. - Vergleichsgrundlage: IEEE 754-2019, Apache Parquet Logical Types — DECIMAL
Offene Probleme
- Es gibt mehrere Exponent/coefficient-Paare, die dieselbe Zahl darstellen, etwa
10×10^-1und1×10^0. - Ob dieses Format das quantum bewahrt, wie Wertgleichheit beurteilt wird und wie der canonical exponent normalisiert wird, ist noch nicht festgelegt.
- Daher darf eine Implementierung außerhalb der Regel der minimalen WORD-Anzahl des coefficient keine Normalisierung von Exponent und coefficient willkürlich erzwingen.
Originaltext des Spezifikationsdokuments
Das Spezifikationsdokument 0x00000000/codecs/0x00000680/latest.geul, gelesen mit geul show (Hexadezimalwerte in Großbuchstaben).
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"