البندالقيمة
الاسمDOC-POINTER (BIND DOC-POINTER في مستند المواصفة)
TAG ID0x041L
Codec ID0x00000410
مستند المواصفة0x00000000/codecs/0x00000410/ (هدف DECLARE 0410)
القسم2 0010 (Reference أخرى)، الإزاحة داخل القسم C = 1
KindReference · التصنيف: إشاري تصريحي
TAG WORD0000 0100 0001 LLLL (000K KKKC CCCC LLLL)
جهة Hugoreference/doc-pointer.md

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

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

الترتيبالحقل (BIND)FIELDالعرضالصيغة المقبولة (CODEC)ENUM
1issuer#2قيمة خام متبقية (0xFFFF)
2doc#3قيمة خام 4 WORD
3version#4قيمة خام 2 WORD

DOC-POINTER هو Reference إشاري تصريحي يشير إلى إصدار واحد من مستند نشره Issuer. يكون هدفًا لنشر المستند وdeprecate وحذفه، وللإصدار المقتبَس، ولما يُكتب عن المستند.

التخطيط

TAG WORD          0000 0100 0001 LLLL      Codec 0x041L
[TAG الامتداد Length]
Issuer            2/4/16 WORD
معرّف المستند     4 WORD
معرّف الإصدار     2 WORD

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

  • عرض Issuer هو ما يتبقى من Payload بعد طرح 6 WORD لمعرّف المستند ومعرّف الإصدار. لا تقسم الـCodec العرض. يكون invalid إذا لم يكن العرض 2 أو 4 أو 16 WORD، أو إذا كانت قيمة Issuer تتسع في عرض أضيق (الصيغة المعيارية للـIssuer).
  • لا يُحذف معرّف الإصدار. فلو سُمح بحذفه لما أمكن تحديد عرض Issuer من طول Payload وحده (Issuer 4 WORD بلا إصدار وIssuer 2 WORD مع إصدار كلاهما 8 WORD).
  • معرّف الإصدار 0 هو الإصدار الأحدث. يرتبط بالإصدار الجاري وقت التفسير. وسائر القيم تثبّت على ذلك الإصدار (PUBLICATION).
  • معرّف المستند 0 هو مستند فهرس تعريف مصطلحات الـIssuer. يُشار إلى الـIssuer نفسه بـISSUER-POINTER.
  • يحجز كل Issuer معرّفي المستند 0x0000000000000000 و0xFFFFFFFFFFFFFFFF (Issuer والنشر). يُستخدم 0xFFFFFFFFFFFFFFFF في قائمة الـIssuer issuers/ الخاصة بالـIssuer 0x00000000، ولا يستخدمه Issuer آخر. وتشير PUBLICATION وDEPRECATION وTOMBSTONE في issuers/versions.geul بهذه القيمة إلى إصدارات القائمة (عنوان النشر وقائمة الإصدارات).
  • هو خانة واحدة في Codec 0x041L. لا يوجد تكميم (Identified).
  • الصيغة التي تشير إلى مستند Issuer هي DOC-POINTER وحدها. الإشارة إلى مستند بـEXTERNAL-ISSUER-* (Issuer ومعرّف المستند ومعرّف الهدف 0) أو بـEXTERNAL-POINTER-* (IMPORT ID ومعرّف الهدف 0) هي invalid.
  • مواضع الاستخدام: DOC-ID وIMPORT-DOC من Meta، وPUBLICATION وDEPRECATION وTOMBSTONE في قائمة الإصدارات.
  • مستند Codec لا معرّف مستند له. يُشار إلى مستند Codec وإصداره بـCODEC-POINTER.

مثال

المستند 0xFFFF000000000001 للـIssuer GEUL 0x00000000.

الإصدارWORD sequence
10418 0000 0000 FFFF 0000 0000 0001 0000 0001
الأحدث (0)0418 0000 0000 FFFF 0000 0000 0001 0000 0000
  • TAG 1 + Issuer 2 + معرّف المستند 4 + معرّف الإصدار 2 = 9 WORD، وLLLL=1000. وTAG هو 0000 0100 0001 1000 = 0418.

صفحات ذات صلة

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

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

SPEC-VERSION 0x0001
DOC-ID 0x0426000000000000041000000000
BODY
#1 DECLARE 0x0410
#2 FIELD #1 rest
#3 FIELD #1 0x0004
#4 FIELD #1 0x0002
#5 BIND #1 "DOC-POINTER"
#6 BIND #2 "issuer"
#7 BIND #3 "doc"
#8 BIND #4 "version"