| Butir | Nilai |
|---|---|
| Nama | UNSIGNED-DECIMAL (dokumen spesifikasi BIND UNSIGNED-DECIMAL) |
| TAG ID | 0x069L |
| Codec ID | 0x00000690 |
| Dokumen spesifikasi | 0x00000000/codecs/0x00000690/ (sasaran DECLARE 0690) |
| Bagian | 3 0011 (Value), offset dalam bagian C = 9 |
| Kind | Value · keluarga: DECIMAL |
| TAG WORD | 0000 0110 1001 LLLL (000K KKKC CCCC LLLL) |
| Deskripsi indeks | C×10^E dari signed exponent E dan coefficient C unsigned dengan WORD minimum |
| Sisi Hugo | value/decimal/unsigned-decimal.md |
Field (dokumen spesifikasi)
Urutan FIELD dalam dokumen adalah urutan field Payload (dokumen spesifikasi Codec).
| Urutan | Field (BIND) | FIELD | Lebar | Format penerima (CODEC) | ENUM |
|---|---|---|---|---|---|
| 1 | exponent | #2 | nilai mentah 2 WORD | ||
| 2 | coefficient | #3 | sisa 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
Eadalah bilangan bulat komplemen dua big-endian signed 32bit yang dicatat dari WORD atas.Cadalah unsigned magnitude berpresisi sembarang yang dibaca dari seluruh WORD sisa mulai dari WORD atas.Cmengikuti aturan WORD minimum yang sama dengan UNSIGNED-INTEGER. 0 adalah0000, dan pada 2 WORD atau lebih WORD pertama0000dilarang.
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 nilai | Payload (E + C) | Penilaian |
|---|---|---|
1×10^0 | 0000 0000 0001 | representasi byte kanonik |
10×10^-1 | FFFF FFFF 000A | representasi byte kanonik, hubungan kanonik dengan representasi di atas adalah masalah terbuka |
1×10^0 | 0000 0000 0000 0001 | tidak kanonik: 0000 di depan coefficient tidak perlu |
| coefficient negatif | tidak berlaku | invalid |
Status format
- Tata letak ini, yang menggabungkan exponent
Esigned 32 bit dengan coefficientCunsigned WORD minimum, adalah format khas GEUL, bukan decimal interchange IEEE 754 maupunDECIMALApache Parquet. DECIMALParquet 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 karenaCunsigned,Ebertanda, dan tidak adanya metadata precision.- Untuk bertukar dengan decimal IEEE 754 atau
DECIMALParquet, 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^-1dan1×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"