ButirNilai
NamaUNSIGNED-DECIMAL (dokumen spesifikasi BIND UNSIGNED-DECIMAL)
TAG ID0x069L
Codec ID0x00000690
Dokumen spesifikasi0x00000000/codecs/0x00000690/ (sasaran DECLARE 0690)
Bagian3 0011 (Value), offset dalam bagian C = 9
KindValue · keluarga: DECIMAL
TAG WORD0000 0110 1001 LLLL (000K KKKC CCCC LLLL)
Deskripsi indeksC×10^E dari signed exponent E dan coefficient C unsigned dengan WORD minimum
Sisi Hugovalue/decimal/unsigned-decimal.md

Field (dokumen spesifikasi)

Urutan FIELD dalam dokumen adalah urutan field Payload (dokumen spesifikasi Codec).

UrutanField (BIND)FIELDLebarFormat penerima (CODEC)ENUM
1exponent#2nilai mentah 2 WORD
2coefficient#3sisa nilai mentah (0xFFFF)

UNSIGNED-DECIMAL adalah Value bilangan desimal eksak (exact decimal) dengan coefficient tak bertanda. Kode langsung Value 0x069L, keluarga DECIMAL. 2 WORD pertama Payload adalah exponent desimal signed 32bit E, sisanya adalah coefficient C unsigned dengan WORD minimum, dan nilainya C×10^E.

Layout

TAG WORD          0000 0110 1001 LLLL      Codec 0x069L
[Length extension TAG] jika total 15 WORD atau lebih
Payload WORD 1st–2nd (32 bit)       Signed Base-10 Exponent E
Payload WORD 3rd–Nth (1 WORD atau lebih)  Unsigned Coefficient C

Interpretasi

  • E adalah bilangan bulat komplemen dua big-endian signed 32bit yang dicatat dari WORD atas.
  • C adalah unsigned magnitude berpresisi sembarang yang dibaca dari seluruh WORD sisa mulai dari WORD atas.
  • C mengikuti aturan WORD minimum yang sama dengan UNSIGNED-INTEGER. 0 adalah 0000, dan pada 2 WORD atau lebih WORD pertama 0000 dilarang.

Panjang dan validitas

  • Total adalah jumlah WORD dari TAG 1 WORD, Length extension TAG (jika ada), dan Payload. 14 WORD atau kurang memakai panjang langsung, 15 WORD atau lebih memakai panjang perluasan 1110·1111, dan extension TAG juga dihitung dalam total (Record dan TAG WORD).
  • Payload terdiri dari exponent 2 WORD dan coefficient 1 WORD atau lebih, sehingga minimal 3 WORD.
  • Kekanonikan representasi byte hanya memeriksa representasi WORD minimum dari coefficient.

Contoh

Representasi nilaiPayload (E + C)Penilaian
1×10^00000 0000 0001representasi byte kanonik
10×10^-1FFFF FFFF 000Arepresentasi byte kanonik, hubungan kanonik dengan representasi di atas adalah masalah terbuka
1×10^00000 0000 0000 0001tidak kanonik: 0000 di depan coefficient tidak perlu
coefficient negatiftidak berlakuinvalid

Status format

  • Tata letak ini, yang menggabungkan exponent E signed 32 bit dengan coefficient C unsigned WORD minimum, adalah format khas GEUL, bukan decimal interchange IEEE 754 maupun DECIMAL Apache Parquet.
  • DECIMAL Parquet memakai unscaled value bertanda, unscaledValue × 10^(-scale), dan metadata precision/scale yang wajib; tipe fisik byte-array adalah komplemen dua big-endian dan scale-nya 0 atau lebih. Format ini bukan format yang sama karena C unsigned, E bertanda, dan tidak adanya metadata precision.
  • Untuk bertukar dengan decimal IEEE 754 atau DECIMAL Parquet, diperlukan konversi eksplisit yang menetapkan kebijakan tanda, rentang, precision/scale, quantum, dan nilai khusus.
  • Dasar perbandingan: IEEE 754-2019, Apache Parquet Logical Types — DECIMAL

Masalah terbuka

  • Ada banyak pasangan exponent/coefficient yang menyatakan bilangan yang sama, seperti 10×10^-1 dan 1×10^0.
  • Belum ditetapkan apakah format ini mempertahankan quantum, bagaimana kesetaraan nilai ditentukan, dan bagaimana canonical exponent dinormalkan.
  • Karena itu implementasi tidak boleh memaksakan secara sepihak normalisasi exponent/coefficient di luar aturan WORD minimum coefficient.

Teks asli dokumen spesifikasi

Tampilan dokumen spesifikasi 0x00000000/codecs/0x00000690/latest.geul yang dibaca dengan geul show (heksadesimal huruf besar).

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"