البندالقيمة
الاسمFRACTION (مستند المواصفة BIND FRACTION)
TAG ID0x067L
Codec ID0x00000670
مستند المواصفة0x00000000/codecs/0x00000670/ (هدف DECLARE هو 0670)
القسم3 0011 (Value)، الإزاحة داخل القسم C = 7
KindValue · العائلة: NUMERIC
TAG WORD0000 0110 0111 LLLL (000K KKKC CCCC LLLL)
وصف الفهرسكسر يحفظ تدوين النص الأصلي: بسط عدد صحيح أو عشري، ومقام عدد صحيح أو عشري بلا إشارة. لا يُختزل
جهة Hugovalue/numeric/fraction.md

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

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

الترتيبالحقل (BIND)FIELDالعرضالصيغة المقبولة (CODEC)ENUM
1numerator#2سجل0610 SIGNED-INTEGER، 0680 SIGNED-DECIMAL
2denominator#3سجل0620 UNSIGNED-INTEGER، 0690 UNSIGNED-DECIMAL

FRACTION قيمة Value تمثل الكسر المكتوب في النص الأصلي بتدوينه نفسه. الرمز المباشر في Value هو 0x067L والعائلة NUMERIC. البسط والمقام كل منهما سجل Value كامل. ولا يُختزل الكسر. وتحفظ هذه الصيغة الكسور التي يكون المكتوب بعينه هو السجل، مثل «ثلثين» و«خمسة من مئة» في القوانين، والحصة العشرية في السجل العقاري 23.45/1256.1.

التخطيط

TAG WORD          0000 0110 0111 LLLL      Codec 0x067L
[TAG ممتد لـ Length] عندما يبلغ المجموع 15 WORD أو أكثر
numerator         سجل Value واحد: SIGNED-INTEGER أو SIGNED-DECIMAL
denominator       سجل Value واحد: UNSIGNED-INTEGER أو UNSIGNED-DECIMAL

التفسير والصلاحية

  • numerator هو سجل SIGNED-INTEGER (0x061L) أو SIGNED-DECIMAL (0x068L) واحد بالضبط.
  • denominator هو سجل UNSIGNED-INTEGER (0x062L) أو UNSIGNED-DECIMAL (0x069L) واحد بالضبط.
  • القائمة مغلقة. لا يُقبل أي Value آخر ولا FRACTION نفسها (التداخل ممنوع) ولا علامة الموضع (0x0000 وغيرها).
  • لكل من السجلين طوله الخاص، فلا تُكتب حدودهما على حدة. يجب أن يطابق المؤشر بعد قراءة السجلين نهاية Payload تماماً.
  • تتبع السجلات الداخلية الصيغة القياسية لكل Codec (العدد الصحيح وcoefficient بأقل عدد من WORD). إذا وُجد سجل داخلي غير قياسي فـ FRACTION كلها invalid.
  • القيمة هي numerator / denominator.

حفظ التدوين

  • العدد الصحيح والعشري: إذا كان مكوّن النص الأصلي عدداً صحيحاً (بلا فاصلة عشرية) فيُستخدم سجل INTEGER، وإذا كانت فيه فاصلة عشرية فيُستخدم سجل DECIMAL. كتابة المكوّن بـ DECIMAL أسّه E = 0 هي invalid. ولهذا يكون للتدوين الواحد تسلسل بايتات واحد.
  • C وE في مكوّن DECIMAL يطابقان عدد خانات النص الأصلي. 23.450 هو 23450×10^-3 وهو Value مختلفة عن 23.45.
  • لا يُختزل الكسر. يُكتب 2/4 و«خمسة من مئة» (5/100) كما هما. وتطابق البايتات يعني تطابق تدوين النص الأصلي.
  • الكسر الذي مقامه 1 (3/1) يُكتب كما هو إذا كان النص الأصلي كذلك. وإذا كان النص الأصلي عدداً صحيحاً فتُستخدم Codec العدد الصحيح لا FRACTION. وإذا كان النص الأصلي عشرياً (0.5 أو 5%) فيُستخدم DECIMAL.
  • توضع الإشارة في البسط وحده. المقام من Codec بلا إشارة.
  • إذا كانت قيمة المقام 0 فهي invalid (0 و0.0 كلاهما).

المقارنة

  • تحسب طبقة المقارنة FRACTION عدداً نسبياً دقيقاً (C1 × 10^E1) / (C2 × 10^E2) (مكوّن INTEGER له E = 0). ولا يُقرَّب بالفاصلة العائمة.
  • تتم المقارنة والفرز وتحديد التكرار بهذه القيمة، ويتم الحفظ والتوقيع وتجزئة المحتوى بالتدوين (البايتات). 2/4 و1/2 و0.5 قيمتها واحدة وبايتاتها مختلفة.
  • يُقارَن الحكم بالنصاب («ثلثان أو أكثر من أصوات المساهمين الحاضرين») بهذه القيمة الدقيقة.

الطول

  • المجموع هو TAG (1 WORD) + (TAG ممتد لـ Length) + سجلان. سجل العدد الصحيح هو TAG (1) + Payload (1 WORD فأكثر)، وسجل العدد العشري هو TAG (1) + الأس (2) + coefficient (1 WORD فأكثر).
  • الكسر الصحيح الصغير 5 WORD، والكسر العشري الصغير 9 WORD. ومن 15 WORD فأكثر يُستخدم الطول الممتد (السجل وTAG WORD).
النص الأصليالمكوّناتالمجموع
2/3INTEGER 2 WORD + INTEGER 2 WORD5 WORD
5/100INTEGER 2 WORD + INTEGER 2 WORD5 WORD
23.45/1256.1DECIMAL 4 WORD + DECIMAL 4 WORD9 WORD

مثال

2/3:

0674 0611 0002 0621 0003
  • TAG 0674 (Codec 0x067L، 5 WORD)، numerator 0611 0002 (SIGNED-INTEGER 2)، denominator 0621 0003 (UNSIGNED-INTEGER 3).

23.45/1256.1:

0678 0683 FFFF FFFE 0929 0693 FFFF FFFF 3111
  • TAG 0678 (9 WORD)، numerator 0683 FFFF FFFE 0929 (SIGNED-DECIMAL E = -2، C = 2345)، denominator 0693 FFFF FFFF 3111 (UNSIGNED-DECIMAL E = -1، C = 12561).

العلاقة بالصيغ الأخرى

  • تقبل amount وlower وupper في QUANTITY صيغة FRACTION. فـ«ثلثا الأصوات الحاضرة» يمكن كتابتها بـ amount تساوي 2/3 في QUANTITY بلا وحدة.
  • يكتب مستند المواصفة 0x00000000/codecs/0x00000670 في geul.org حقلي سجلات: numerator (0610·0680) وdenominator (0620·0690) (مستند مواصفة Codec).
  • إذا لزم كسر ثابت int64 يفرض الاختزال فتُستخدم صيغة Issuer RATIONAL-I64.

مسائل مفتوحة

  1. حفظ تدوين العدد الكسري المختلط (1 و2/3).
  2. صيغة تحمل كسراً لمكوّنيه وحدة (مساحة/مساحة) في QUANTITY اثنتين. FRACTION لا تحمل وحدة.
  3. معيار التدوين لتمثيل النسبة المئوية والألفية (5% و5‰) بـ DECIMAL مع وحدة أم بـ FRACTION (5/100).
  4. الكسر المركب (FRACTION في البسط والمقام). ممنوع حالياً.

صفحات ذات صلة

نص مستند المواصفة

هذا ما يظهر عند قراءة مستند المواصفة 0x00000000/codecs/0x00000670/latest.geul بالأمر geul show (الأرقام الستة عشرية بأحرف كبيرة).

SPEC-VERSION 0x0001
DOC-ID 0x0426000000000000067000000000
BODY
#1 DECLARE 0x0670
#2 FIELD #1 record
#3 FIELD #1 record
#4 BIND #1 "FRACTION"
#5 BIND #2 "numerator"
#6 BIND #3 "denominator"
#7 CODEC #2 0x0610
#8 CODEC #2 0x0680
#9 CODEC #3 0x0620
#10 CODEC #3 0x0690