EintragWert
NameSIGNED-DECIMAL (Spezifikationsdokument BIND SIGNED-DECIMAL)
TAG ID0x068L
Codec ID0x00000680
Spezifikationsdokument0x00000000/codecs/0x00000680/ (DECLARE-Ziel 0680)
Abschnitt3 0011 (Value), Offset C im Abschnitt = 8
KindValue · Familie: DECIMAL
TAG WORD0000 0110 1000 LLLL (000K KKKC CCCC LLLL)
Index-BeschreibungC×10^E aus vorzeichenbehaftetem Exponenten E und Zweierkomplement-coefficient C mit minimaler WORD-Anzahl
Hugo-Seitevalue/decimal/signed-decimal.md

Felder (Spezifikationsdokument)

Die Reihenfolge der FIELD im Dokument ist die Reihenfolge der Payload-Felder (Codec-Spezifikationsdokument).

Nr.Feld (BIND)FIELDBreiteZielformat (CODEC)ENUM
1exponent#2Rohwert 2 WORD
2coefficient#3restlicher 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

  • E ist eine vorzeichenbehaftete 32-Bit-big-endian-Zweierkomplement-Ganzzahl, beginnend mit dem oberen WORD.
  • C ist eine Zweierkomplement-Ganzzahl beliebiger Genauigkeit, die durch Aneinanderfügen aller übrigen WORD, beginnend mit dem oberen WORD, entsteht.
  • C folgt derselben Regel der minimalen WORD-Anzahl wie SIGNED-INTEGER. Führende 0000- oder FFFF-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

WertdarstellungPayload (E + C)Beurteilung
1×10^00000 0000 0001Byte-Darstellung kanonisch
10×10^-1FFFF FFFF 000AByte-Darstellung kanonisch, die Canonical-Beziehung zur obigen Darstellung ist ein offenes Problem
1×10^00000 0000 0000 0001nicht kanonisch: führendes 0000 im coefficient überflüssig
Payload 7 WORDdirekte Länge LLLL=0111, insgesamt 8 WORDkanonische Längenstruktur

Formatstatus

  • Diese Anordnung, die einen 32-Bit-Exponenten E mit Vorzeichen und einen coefficient C mit minimaler WORD-Anzahl verbindet, ist ein GEUL-eigenes Format und weder IEEE-754-Decimal-Interchange noch Apache Parquet DECIMAL.
  • Parquet DECIMAL verwendet unscaledValue × 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 vorzeichenbehaftetes E in den Datenteil und hat keine precision-Metadaten, ist also nicht dasselbe Format.
  • Für den Austausch mit IEEE-754-Decimal oder Parquet DECIMAL ist 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^-1 und 1×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"