Value سجل يحمل القيمة نفسها. ويحدد Codec تفسير Payload.

التخطيط

TAG WORD          000K KKKC CCCC LLLL      القسمان 3 و4 (0x060L~0x09FL)
[Length ممتد TAG]
[Codec ممتد TAG]  عند صيغة Issuer
Payload
  • LLLL هو عدد WORD الكلي شاملاً TAG WORD ناقصاً 1. من 1 إلى 14 WORD طول مباشر، ومن 15 WORD فأكثر طول ممتد.
  • في صيغة Issuer يوضع في TAG Codec الممتد Issuer (بعرض 2/4/16 WORD يحدده Codec) ورقم Codec بـ 2 WORD. ورقم Codec يحدده Issuer.
  • يعرف المفكّك حتى لو لم يعرف الصيغة: Kind وLength وIssuer ورقم Codec.

العائلة

رقم Value لا يدل على العائلة. فالرموز المباشرة لا تدل بالبتات على العائلة، ولا قاعدة للعائلة في صيغ Issuer كذلك. والعائلة تجميع موضوعي.

العائلةالرموز المباشرة
NUMERIC0x060L~0x067L
DECIMAL0x068L~0x069L
TIME0x06AL~0x071L, 0x081L
TEXT0x072L~0x07AL
BINARY0x07BL~0x080L
  • القيم العددية مثل المتجهات والتنسورات والأعداد المركبة والكسور والمجالات هي NUMERIC. واستثناؤها BIT-VECTOR فهو BINARY. ورموز اللغات TEXT.
  • يلحق بسجل صيغة Issuer TAG Codec الممتد (Issuer ورقم Codec). وإذا طال Payload (المجموع 15 WORD فأكثر) يُستعمل TAG Length الممتد.

الرموز المباشرة

Codecالاسمالعائلةالوصف
0x060LBOOLNUMERICfalse أو true
0x061LSIGNED-INTEGERNUMERICعدد صحيح بتكميل الاثنين بأقل عدد من WORD
0x062LUNSIGNED-INTEGERNUMERICعدد صحيح غير موقّع بأقل عدد من WORD
0x063LBINARY-FLOATNUMERICIEEE 754 binary16/32/64/128
0x064LCOORDINATE-EARTHNUMERICخط العرض والطول على الأرض (WGS 84) وعدم اليقين (Reference الوحدة)
0x065LCOORDINATE-GEONUMERICReference الجرم السماوي وخط العرض والطول وعدم اليقين (Reference الوحدة)
0x066LQUANTITYNUMERICكمية عددية (عدد صحيح·BINARY-FLOAT·عدد عشري·كسر) وReference الوحدة والحد الأدنى والأعلى
0x067LFRACTIONNUMERICكسر يحفظ الكتابة (سجلا البسط والمقام، دون اختزال)
0x068LSIGNED-DECIMALDECIMALC × 10^E، معامل موقّع
0x069LUNSIGNED-DECIMALDECIMALC × 10^E، معامل غير موقّع
0x06ALGREGORIAN-DATETIMEعدد الأيام منذ 1970-01-01 (التقويم الغريغوري)
0x06BLCIVIL-TIME-NANOSECONDSTIMEالنانوثانية منذ منتصف الليل
0x06CLPOSIX-TIMESTAMP-SECONDSTIMEالثواني منذ Unix epoch
0x06DLDURATION-SECONDSTIMEالزمن المنقضي (بالثواني)
0x06EL/0x06FLEDTFTIMEسلسلة تاريخ ممتدة في ISO 8601-2 (دقة السنة والشهر، وعدم اليقين، والمدى)
0x070L/0x071LGEDCOM-DATETIMEسلسلة تاريخ GEDCOM 7 (التقاويم الأخرى كاليولياني)
0x072L/0x073LUTF8-TEXTTEXTسلسلة UTF-8 بلا لغة
0x074L/0x075LURITEXTURI وفق RFC 3986
0x076L/0x077LLANGUAGE-BCP47-CODETEXTوسم لغة BCP 47
0x078L/0x079LUTF8-LANGUAGE-TEXTTEXTنص موسوم بلغته
0x07ALLANGUAGE-SHORT-CODETEXTرمز لغة مضغوط بـ 1 WORD
0x07BLUUIDBINARYUUID وفق RFC 9562
0x07CLSHA-256-DIGESTBINARYناتج SHA-256
0x07DLSHA1-DIGESTBINARYناتج SHA-1 (لأغراض التعريف كمعرّف كائن git)
0x07EL/0x07FLOPAQUE-BYTESBINARYسلسلة بايتات مجهولة المعنى والصيغة. بايتات زوجية·فردية
0x080LBIT-VECTORBINARYN بت مخزَّنة بترتيب MSB-first بعد bit-count
0x081LDURATION-NANOSECONDSTIMEالزمن المنقضي (بالنانوثانية)
  • الرموز المقترنة زوجياً/فردياً هي سلاسل بايتات متغيرة الطول. الرمز الزوجي لعدد البايتات الزوجي، والفردي للفردي (السجل وTAG WORD).
  • الرموز المباشرة في 0x060L~0x081L بلا Reserved. أما 0x082L~0x09CL فهي Reserved، و0x09DL~0x09FL هي VALUE-ISSUER-2WORD·4WORD·16WORD.

صيغ Issuer

الصيغة التي ليست في الرموز المباشرة توضع برقم Codec تحت Issuer الجهة التي وضعتها. والصيغ العرفية التي لا جهة واضعة لها توضع تحت ADHOC (0x00000002). أما الصيغ الخاصة بـ GEUL (OPAQUE-BYTES وBIT-VECTOR وDURATION-NANOSECONDS) فهي رموز مباشرة.

Issuerأمثلة على الصيغ
ADHOC 0x00000002BFLOAT16، متجهات الأعداد الصحيحة·الحقيقية، التنسورات، الأعداد المركبة، الكسور، المجالات، الرباعيات (quaternion)، BLAKE3
IETF 0x00000007URI النسبي، CRC32C، عناوين IPv4·IPv6
IEEE 0x0000000DIEEE 754 decimal32/64/128، ختم POSIX زمني بالنانوثانية، عنوان MAC
KHRONOS 0x0000000Eبكسلات RGBA8·BGRA8
ONNX 0x00000010, OCP 0x00000011FP8, FP4
BIPM 0x00000013ختم TAI الزمني
NIST 0x00000015SHA-512, SHA3-256
GPS 0x00000016ختم GPS الزمني
  • يعرف المفكّك الذي لا يعرف الصيغة Issuer ورقم Codec ويتخطى الباقي بـ Length.
  • يوضع مستند Codec تحت codecs/ عند ذلك Issuer برقم Codec السجل. مثال: CRC32C في IETF هو 0x00000007/codecs/0x0000C000/ (عناوين النشر وقائمة الإصدارات).
  • يُوصى بالإحالة إلى القيم الكبيرة كالصور والفيديو بـ URI وSHA-256 بدل وضعها مباشرة.
  • المصنفات داخل سلسلة البايتات تخضع لترخيصها الأصلي. يُسجَّل المصدر والترخيص في Meta.

حزم الصيغ

شرح كل حزمة أدناه. أما تخطيط كل صيغة وتفسيرها وصلاحيتها وأمثلتها ففي مستندها الخاص.

الحزمةالعائلةالصيغ
numericNUMERICBOOL، الأعداد الصحيحة، الفاصلة العائمة، الإحداثيات، QUANTITY، FRACTION
decimalDECIMALSIGNED-DECIMAL، UNSIGNED-DECIMAL، IEEE 754 decimal32/64/128
timeTIMEالتاريخ، الوقت، الأختام الزمنية، الزمن المنقضي، EDTF، تاريخ GEDCOM
textTEXTنص UTF-8، النص الموسوم بلغته، URI، رموز اللغات
binaryBINARYUUID، الملخصات (digest)، CRC، عناوين الشبكة، البايتات المجهولة، متجه البتات
vectorNUMERICمتجهات كثيفة من الأعداد الصحيحة·الحقيقية، النقاط·صناديق الإحاطة، بكسلات RGBA·BGRA
tensorNUMERICتنسورات dense·packed ذات صيغة وrank وshape
etcNUMERICالأعداد المركبة، الكسور، المجالات المغلقة، الرباعيات
  • حزم vector وtensor وetc كلها صيغ Issuer (ADHOC وKHRONOS) من عائلة NUMERIC.

numeric

صيغ الأعداد الأساسية في عائلة NUMERIC. توضع في الرموز المباشرة 0x060L~0x067L.

  • وتشمل BOOL والأعداد الصحيحة الموقّعة وغير الموقّعة والفاصلة العائمة binary في IEEE 754 والإحداثيات على الأرض (WGS 84) والأجرام السماوية، وQUANTITY الذي يجمع الكمية والوحدة والحدود، وFRACTION للكسر بكتابته الأصلية.
  • يُكتب العدد الصحيح بأقل عدد من WORD تتسع له القيمة.
  • صيغ Issuer للقيم الصغيرة (BFLOAT16 وFP8 وFP4) خُصصت لها أرقام Codec فقط وليست لها مواصفة مفصلة (Value مسائل مفتوحة).
  • المتجهات والتنسورات والأعداد المركبة والكسر المختزل (RATIONAL-I64) والمجالات من عائلة NUMERIC أيضاً، لكنها صيغ Issuer فتوضع في حزم vector وtensor وetc.

decimal

عائلة DECIMAL صيغ الأعداد العشرية الدقيقة. توضع في الرموز المباشرة 0x068L~0x069L.

  • يُكتب SIGNED-DECIMAL وUNSIGNED-DECIMAL المباشران بالشكل C × 10^E ويحملان عدد خانات الكتابة الأصلية كما هو. فـ 1.20 (C=120, E=−2) و1.2 (C=12, E=−1) سجلان مختلفان. أما تكافؤ القيمتين وحفظ quantum فمسألة مفتوحة في SIGNED-DECIMAL.
  • ترميز DPD وBID في IEEE 754 decimal32/64/128 صيغة من Issuer الخاص بـ IEEE (0x0000000D).

time

عائلة TIME صيغ التاريخ والوقت. توضع في الرموز المباشرة 0x06AL~0x071L و0x081L (DURATION-NANOSECONDS).

الدقةالصيغة
التاريخ (الغريغوري)GREGORIAN-DATE
السنة·الشهر، وعدم اليقين، والمدىEDTF
الكتابة الأصلية لتقويم آخر (اليولياني وغيره)GEDCOM-DATE
الوقتأختام POSIX·TAI·GPS الزمنية
الزمن المنقضيDURATION-SECONDS، DURATION-NANOSECONDS
  • التاريخ الذي يمكن كتابته بـ GREGORIAN-DATE لا يُكتب بـ EDTF.
  • الختم الزمني بالنانوثانية وصيغتا TAI وGPS صيغ تحت Issuer الهيئات المعيارية (IEEE وBIPM وGPS).

text

عائلة TEXT صيغ النصوص ومعرّفات السلاسل. توضع في الرموز المباشرة 0x072L~0x07AL.

  • السلسلة بلا لغة هي UTF8-TEXT، والنص الذي له لغة كالأسماء والعناوين والجمل هو UTF8-LANGUAGE-TEXT.
  • رموز اللغات (LANGUAGE-SHORT-CODE وLANGUAGE-BCP47-CODE) من عائلة TEXT أيضاً.
  • سلاسل البايتات المتغيرة الطول تُوضع في زوج Codec زوجي/فردي. إن كان أدنى بت 1 فعدد البايتات فردي وبايت آخر WORD الأدنى هو padding بـ 0x00 (السجل وTAG WORD).

binary

عائلة BINARY صيغ سلاسل البايتات. توضع في الرموز المباشرة 0x07BL~0x080L.

  • UUID وSHA-256 وSHA-1 والبايتات المجهولة (OPAQUE-BYTES) ومتجه البتات (BIT-VECTOR) رموز مباشرة. أما بقية الملخصات وCRC32C وعناوين IPv4·IPv6·MAC فهي صيغ Issuer.
  • القيم ذات الحجم الثابت (UUID والملخصات والعناوين) حجمها محدد، فلا يُنشأ لها زوج زوجي/فردي.
  • الوسائط العامة كالصور والفيديو توضع كصيغة من Issuer الخاص بـ IANA (0x00000008). تُخصَّص أرقام Codec في أزواج زوجي/فردي، وPayload سلسلة بايتات. الحد الأقصى لـ Length هو 2^32−1 WORD. يُوصى بالإحالة إلى القيم الكبيرة بـ URI وSHA-256 بدل وضعها مباشرة.
  • المصنفات داخل سلسلة البايتات تخضع لترخيصها الأصلي. يُسجَّل المصدر والترخيص في Meta.

vector

صيغ المتجهات صيغ Issuer من عائلة NUMERIC. المتجهات الكثيفة من الأعداد الصحيحة·الحقيقية والنقاط·صناديق الإحاطة توضع تحت ADHOC (0x00000002) بأرقام Codec من 0x00000500 إلى 0x0000050C، وصيغ البكسلات تحت KHRONOS (0x0000000E).

  • تُخزَّن عناصر المتجه الكثيف متصلة بترتيب big-endian.
  • ولأنها صيغ Issuer يلحق بـ TAG Codec الممتد Issuer بـ 2 WORD ورقم Codec بـ 2 WORD.

tensor

صيغ التنسورات صيغ Issuer من عائلة NUMERIC. توضع تحت ADHOC (0x00000002) بأرقام Codec من 0x00000600 إلى 0x00000601.

  • يحمل DESCRIBED-DENSE-TENSOR صيغة العنصر وrank وshape وpayload كثيفاً بترتيب C-contiguous.
  • يحمل DESCRIBED-PACKED-TENSOR صيغة packed وrank وshape وpayload مكدّساً بترتيب low-bit-first داخل octet.

etc

صيغ الأعداد الأخرى صيغ Issuer من عائلة NUMERIC. توضع تحت ADHOC (0x00000002) بأرقام Codec من 0x00000700 إلى 0x00000704.

  • وتشمل الأعداد المركبة (COMPLEX64 وCOMPLEX128) والكسر المطبَّع (RATIONAL-I64) والمجال المغلق بـ binary64 والرباعيات بـ binary32.

النص

النص الذي له لغة والنص الذي بلا لغة قيمتان مختلفتان. فـ «Paris» (سلسلة) و«Paris» (بالفرنسية) ليستا متساويتين.

الصيغةموضع الاستعمال
UTF8-TEXTالسلاسل التي لا لغة لها كالمعرّفات والرموز وأسماء الملفات والمعرّفات الخارجية
UTF8-LANGUAGE-TEXTالنص الذي له لغة كالأسماء والعناوين والجمل
UTF8-LANGUAGE-TEXT
TAG WORD          0000 0111 100P LLLL   (P = بايتات النص فردية)
[Length ممتد TAG]
اللغة             سجل LANGUAGE-SHORT-CODE أو LANGUAGE-BCP47-CODE
النص              بايتات UTF-8 (إن كان العدد فردياً فآخر بايت 0x00)
  • النص UTF-8 سليم التكوين ويُحفظ كما في الأصل. ويتولى التطبيع الجهة التي تقارن أو تفهرس.
  • الاسم المشترك بين لغات كثيرة يُكتب بلغة mul، واللغة غير المحددة und. والسلسلة التي بلا محتوى لغوي هي UTF8-TEXT.

مثال: "Douglas Adams"@en (13 بايتاً، فردي)

0799  0761 656E  446F 7567 6C61 7320 4164 616D 7300
TAG   اللغة en   D o  u g  l a  s ␠  A d  a m  s (padding)

الأعداد العشرية والكميات

يُكتب العدد العشري الدقيق بالشكل C × 10^E. الأس E من 32 بت، والمعامل C بتكميل الاثنين بأقل عدد من WORD. ويُحمل عدد خانات الكتابة الأصلية كما هو: 1.20 هو C=120, E=−2، و1.2 هو C=12, E=−1. الكتابتان تمثلان العدد نفسه لكنهما سجلان منفصلان مختلفا البايتات. ولا يطبّع المرمِّز الكتابة اعتباطاً. أما تكافؤ القيمة بين السجلين ومعنى quantum (الأرقام المعنوية) فمسألة مفتوحة (SIGNED-DECIMAL).

يحمل QUANTITY الكمية والوحدة والحدود في قيمة واحدة.

TAG WORD          0000 0110 0110 LLLL
[Length ممتد TAG]
الكمية            سجل Value عددي (عدد صحيح·BINARY-FLOAT·عدد عشري·كسر)
الوحدة            سجل Reference (بند الوحدة)، وإن لم تكن وحدة فـ 0x0000
الحد الأدنى       سجل Value عددي، وإن حُذف فـ 0x0000 ABSENT
الحد الأعلى       سجل Value عددي، وإن حُذف فـ 0x0000 ABSENT
  • الوحدة جزء من القيمة. فلا تُفصل وتُكتب في موضع آخر (فبدونها لا يُعرف هل 652 كيلومترات أم أمتار).
  • لا تُحمل القيمة المحوّلة إلى وحدات SI. فيمكن حسابها من الوحدة وجدول التحويل.
  • 0x0000 علامة ABSENT على حذف الحقل الاختياري (مستند مواصفة Codec).

مثال: 652 km، المدى [651, 653] (km = Q828224 في Wikidata)

066E 0011                    TAG (طول ممتد 17 WORD)
0683 0000 0000 028C          الكمية 652
0142 000C A340               الوحدة Q828224
0683 0000 0000 028B          الحد الأدنى 651
0683 0000 0000 028D          الحد الأعلى 653

التاريخ

الدقةالصيغة
التاريخ (الغريغوري)GREGORIAN-DATE
السنة·الشهر، وعدم اليقين (1971~)، والمدىEDTF
الكتابة الأصلية لتقويم آخر (اليولياني وغيره)GEDCOM-DATE
الوقتأختام POSIX·TAI·GPS الزمنية
  • التاريخ الذي يمكن كتابته بـ GREGORIAN-DATE لا يُكتب بـ EDTF.

مسائل مفتوحة

  • صيغ الوسائط العامة (JPEG وPNG وMP4 وMOV وغيرها) توضع برقم Codec عند Issuer الخاص بـ IANA (0x00000008). طريقة إدارة جدول المطابقة بين نوع الوسائط ورقم Codec.
  • القائمة النهائية لرموز Value المباشرة. تُحدَّد بقياس تكرار Value في عينات القوانين ومحادثات العمل (مرشحات: المبالغ والنسب المئوية ومدى التواريخ).
  • المواصفة المفصلة وموضع القيم الصغيرة السبع (BFLOAT16 في ADHOC، وأربعة FP8 في ONNX، وFP8-E8M0FNU وFP4-E2M1FN في OCP). لم يُقرَّر نقلها إلى رموز مباشرة. وحالياً خُصصت لها أرقام Codec فقط.