البندالقيمة
الاسمSIGNED-DECIMAL (مستند المواصفة BIND SIGNED-DECIMAL)
TAG ID0x068L
Codec ID0x00000680
مستند المواصفة0x00000000/codecs/0x00000680/ (هدف DECLARE هو 0680)
القسم3 0011 (Value)، الإزاحة داخل القسم C = 8
KindValue · العائلة: DECIMAL
TAG WORD0000 0110 1000 LLLL (000K KKKC CCCC LLLL)
وصف الفهرسC×10^E من signed exponent E وcoefficient C بمتمم الاثنين وبأقل عدد من WORD
جهة Hugovalue/decimal/signed-decimal.md

الحقول (مستند المواصفة)

ترتيب FIELD داخل المستند هو ترتيب حقول Payload (مستند مواصفة Codec).

الترتيبالحقل (BIND)FIELDالعرضالصيغة المقبولة (CODEC)ENUM
1exponent#2قيمة خام 2 WORD
2coefficient#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^00000 0000 0001تمثيل البايتات قياسي
10×10^-1FFFF FFFF 000Aتمثيل البايتات قياسي، والعلاقة القياسية (canonical) بالتمثيل أعلاه مسألة مفتوحة
1×10^00000 0000 0000 0001غير قياسي: 0000 سابقة في coefficient لا حاجة إليها
Payload من 7 WORDطول مباشر LLLL=0111، المجموع 8 WORDبنية طول قياسية

مكانة الصيغة

  • هذا التوزيع الذي يجمع exponent E من نوع signed 32 بت وcoefficient C بأقل عدد من WORD هو صيغة خاصة بـ GEUL، وليس IEEE 754 decimal interchange ولا Apache Parquet DECIMAL.
  • يستخدم 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"