EintragWert
NameUNSIGNED-DECIMAL (Spezifikationsdokument BIND UNSIGNED-DECIMAL)
TAG ID0x069L
Codec ID0x00000690
Spezifikationsdokument0x00000000/codecs/0x00000690/ (DECLARE-Ziel 0690)
Abschnitt3 0011 (Value), Offset C im Abschnitt = 9
KindValue · Familie: DECIMAL
TAG WORD0000 0110 1001 LLLL (000K KKKC CCCC LLLL)
Index-BeschreibungC×10^E aus vorzeichenbehaftetem Exponenten E und Unsigned-coefficient C mit minimaler WORD-Anzahl
Hugo-Seitevalue/decimal/unsigned-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)

UNSIGNED-DECIMAL ist ein Value für eine exakte Dezimalzahl (exact decimal) mit vorzeichenlosem coefficient. Direkter Value-Code 0x069L, Familie DECIMAL. Die ersten 2 WORD des Payload sind der 32-Bit-Dezimalexponent E mit Vorzeichen, der Rest ist der Unsigned-coefficient C mit minimaler WORD-Anzahl, und der Wert ist C×10^E.

Layout

TAG WORD          0000 0110 1001 LLLL      Codec 0x069L
[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)    Unsigned Coefficient C

Interpretation

  • E ist eine vorzeichenbehaftete 32-Bit-big-endian-Zweierkomplement-Ganzzahl, beginnend mit dem oberen WORD.
  • C ist eine Unsigned Magnitude beliebiger Genauigkeit, die aus allen übrigen WORD, beginnend mit dem oberen WORD, gelesen wird.
  • C folgt derselben Regel der minimalen WORD-Anzahl wie UNSIGNED-INTEGER. 0 ist 0000, und bei 2 WORD oder mehr ist ein erstes WORD 0000 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
negativer coefficientnicht zutreffendinvalid

Formatstatus

  • Diese Anordnung, die einen 32-Bit-Exponenten E mit Vorzeichen und einen Unsigned-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 einen vorzeichenbehafteten unscaled value, unscaledValue × 10^(-scale) und obligatorische Metadaten precision/scale; der Byte-Array-Typ ist big-endian Zweierkomplement, und scale ist mindestens 0. Dieses Format ist wegen des Unsigned C, des vorzeichenbehafteten E und des Fehlens von precision-Metadaten nicht dasselbe Format.
  • Für den Austausch mit IEEE-754-Decimal oder Parquet DECIMAL ist eine explizite Konvertierung nötig, die Vorzeichen, 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/0x00000690/latest.geul, gelesen mit geul show (Hexadezimalwerte in Großbuchstaben).

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"