| البند | القيمة |
|---|---|
| الاسم | DOC-POINTER (BIND DOC-POINTER في مستند المواصفة) |
| TAG ID | 0x041L |
| Codec ID | 0x00000410 |
| مستند المواصفة | 0x00000000/codecs/0x00000410/ (هدف DECLARE 0410) |
| القسم | 2 0010 (Reference أخرى)، الإزاحة داخل القسم C = 1 |
| Kind | Reference · التصنيف: إشاري تصريحي |
| TAG WORD | 0000 0100 0001 LLLL (000K KKKC CCCC LLLL) |
| جهة Hugo | reference/doc-pointer.md |
الحقول (مستند المواصفة)
ترتيب FIELD داخل المستند هو ترتيب حقول Payload (مستند Codec).
| الترتيب | الحقل (BIND) | FIELD | العرض | الصيغة المقبولة (CODEC) | ENUM |
|---|---|---|---|---|---|
| 1 | issuer | #2 | قيمة خام متبقية (0xFFFF) | ||
| 2 | doc | #3 | قيمة خام 4 WORD | ||
| 3 | version | #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في قائمة الـIssuerissuers/الخاصة بالـIssuer0x00000000، ولا يستخدمه 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 |
|---|---|
| 1 | 0418 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"