| البند | القيمة |
|---|---|
| الاسم | SIGNED-DECIMAL (مستند المواصفة BIND SIGNED-DECIMAL) |
| TAG ID | 0x068L |
| Codec ID | 0x00000680 |
| مستند المواصفة | 0x00000000/codecs/0x00000680/ (هدف DECLARE هو 0680) |
| القسم | 3 0011 (Value)، الإزاحة داخل القسم C = 8 |
| Kind | Value · العائلة: DECIMAL |
| TAG WORD | 0000 0110 1000 LLLL (000K KKKC CCCC LLLL) |
| وصف الفهرس | C×10^E من signed exponent E وcoefficient C بمتمم الاثنين وبأقل عدد من WORD |
| جهة Hugo | value/decimal/signed-decimal.md |
الحقول (مستند المواصفة)
ترتيب FIELD داخل المستند هو ترتيب حقول Payload (مستند مواصفة Codec).
| الترتيب | الحقل (BIND) | FIELD | العرض | الصيغة المقبولة (CODEC) | ENUM |
|---|---|---|---|---|---|
| 1 | exponent | #2 | قيمة خام 2 WORD | ||
| 2 | coefficient | #3 | القيمة الخام المتبقية (0xFFFF) |
SIGNED-DECIMAL قيمة Value تمثل عدداً عشرياً دقيقاً (exact decimal) بمعامل coefficient ذي إشارة. الرمز المباشر في Value هو 0x068L والعائلة DECIMAL. أول WORD اثنتين من Payload هما exponent عشري E من نوع signed 32bit، والباقي coefficient C بمتمم الاثنين وبأقل عدد من WORD، والقيمة هي C×10^E.
التخطيط
TAG WORD 0000 0110 1000 LLLL Codec 0x068L
[TAG ممتد لـ Length] عندما يبلغ المجموع 15 WORD أو أكثر
Payload WORD 1st–2nd (32 بت) Signed Base-10 Exponent E
Payload WORD 3rd–Nth (1 WORD فأكثر) Signed Two's-complement Coefficient C
التفسير
Eعدد صحيح بمتمم الاثنين من نوع signed 32bit big-endian يُسجَّل بدءاً من WORD العليا.Cعدد صحيح بمتمم الاثنين وبدقة اعتباطية، تُوصَل فيه كل WORD المتبقية بدءاً من WORD العليا.- يتبع
Cقاعدة أقل عدد من WORD نفسها في SIGNED-INTEGER. تُمنع WORD السابقة0000أوFFFFالتي يمكن حذفها.
الطول والصلاحية
- المجموع هو عدد WORD في TAG (1 WORD) وTAG الممتد لـ Length (إن وُجد) وPayload معاً. يُستخدم الطول المباشر حتى 14 WORD، والطول الممتد
1110·1111من 15 WORD فأكثر، وتُحسب TAG الممتدة ضمن المجموع (السجل وTAG WORD). - Payload هو exponent (2 WORD) وcoefficient (1 WORD فأكثر)، فحده الأدنى 3 WORD.
- لا يُفحص في قياسية تمثيل البايتات إلا تمثيل coefficient بأقل عدد من WORD.
مثال
| تمثيل القيمة | Payload (E + C) | الحكم |
|---|---|---|
1×10^0 | 0000 0000 0001 | تمثيل البايتات قياسي |
10×10^-1 | FFFF FFFF 000A | تمثيل البايتات قياسي، والعلاقة القياسية (canonical) بالتمثيل أعلاه مسألة مفتوحة |
1×10^0 | 0000 0000 0000 0001 | غير قياسي: 0000 سابقة في coefficient لا حاجة إليها |
| Payload من 7 WORD | طول مباشر LLLL=0111، المجموع 8 WORD | بنية طول قياسية |
مكانة الصيغة
- هذا التوزيع الذي يجمع exponent
Eمن نوع signed 32 بت وcoefficientCبأقل عدد من WORD هو صيغة خاصة بـ GEUL، وليس IEEE 754 decimal interchange ولا Apache ParquetDECIMAL. - يستخدم Parquet
DECIMALالصيغةunscaledValue × 10^(-scale)مع metadata إلزامية لـ precision/scale، ويخزن unscaled value في النوع الفيزيائي byte-array بمتمم الاثنين big-endian، وscale فيه 0 أو أكثر. أما هذه الصيغة فتضعEذا الإشارة في المتن ولا metadata لـ precision فيها، فليستا الصيغة نفسها. - التبادل مع IEEE 754 decimal أو Parquet
DECIMALيتطلب تحويلاً صريحاً يحدد المدى وprecision/scale وquantum وسياسة القيم الخاصة. - مرجع المقارنة: IEEE 754-2019، Apache Parquet Logical Types — DECIMAL
مسائل مفتوحة
- هناك عدة أزواج exponent/coefficient تمثل العدد نفسه، مثل
10×10^-1و1×10^0. - لم يُحدَّد بعد هل تحفظ هذه الصيغة quantum، وكيف يُحكم بتساوي القيم، وكيف يُطبَّع canonical exponent.
- لذلك يجب ألا تفرض التطبيقات تطبيعاً لـ exponent/coefficient خارج قاعدة أقل عدد من WORD لـ coefficient.
نص مستند المواصفة
هذا ما يظهر عند قراءة مستند المواصفة 0x00000000/codecs/0x00000680/latest.geul بالأمر geul show (الأرقام الستة عشرية بأحرف كبيرة).
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"