| البند | القيمة |
|---|---|
| الاسم | LOCAL (حزمة 5Q. اسم كل رمز في جدول الأعضاء أدناه) |
| TAG ID | 0x005L~0x009L |
| القسم | 0 0000 (كيان Reference)، الإزاحة داخل القسم C = 5~9 |
| Kind | Reference · التصنيف: تصريح |
| جهة Hugo | reference/local.md |
الأعضاء
تتناول هذه الصفحة منظومة 5Q واحدة، أي خمسة رموز معًا. التكميم هو الإزاحة داخل القسم C % 5 (Reference). لكل رمز مستند Codec واحد. حقول مستندات Codec الخمسة واحدة، ويختلف فقط هدف DECLARE والاسم (BIND).
| TAG ID | الاسم | التكميم | Codec ID | مستند المواصفة | TAG WORD |
|---|---|---|---|---|---|
0x005L | LOCAL-IDENTIFIED | Identified | 0x00000050 | 0x00000000/codecs/0x00000050/ | 0000 0000 0101 LLLL |
0x006L | LOCAL-GENERIC | Generic | 0x00000060 | 0x00000000/codecs/0x00000060/ | 0000 0000 0110 LLLL |
0x007L | LOCAL-FREE-CHOICE | Free-choice | 0x00000070 | 0x00000000/codecs/0x00000070/ | 0000 0000 0111 LLLL |
0x008L | LOCAL-UNIVERSAL | Universal | 0x00000080 | 0x00000000/codecs/0x00000080/ | 0000 0000 1000 LLLL |
0x009L | LOCAL-VARIABLE | Variable | 0x00000090 | 0x00000000/codecs/0x00000090/ | 0000 0000 1001 LLLL |
الحقول (مستند المواصفة)
ترتيب FIELD داخل المستند هو ترتيب حقول Payload (مستند Codec).
| الترتيب | الحقل (BIND) | FIELD | العرض | الصيغة المقبولة (CODEC) | ENUM |
|---|---|---|---|---|---|
| 1 | local-id | #2 | قيمة خام متبقية (0xFFFF) |
LOCAL هو Reference تصريحي يشير إلى الهدف بمعرّف أصدره هذا المستند. يُحيل إلى هدف داخل المستند دون Issuer خارجي. وللإشارة من خارج المستند يوضع في المستند DOC-ID من Meta، وتشير إليه مستندات أخرى بـReference إشاري.
التخطيط
TAG WORD 0000 0000 0101 LLLL Codec 0x005L~0x009L (Identified 0x005L)
[TAG الامتداد Length]
LOCAL ID unsigned big-endian بأقصر عرض
| LOCAL ID | الإجمالي | TAG WORD (Identified) |
|---|---|---|
0..65535 | 2 WORD | 0x0051 |
65536..2^32-1 | 3 WORD | 0x0052 |
2^32..2^48-1 | 4 WORD | 0x0053 |
2^48..2^64-1 | 5 WORD | 0x0054 |
- الـCodec هي
0x005L(Identified) و0x006L(Generic) و0x007L(Free-choice) و0x008L(Universal) و0x009L(Variable). TAG WORD لـIdentified هو0000 0000 0101 LLLL. - تُتَّبع القاعدة المشتركة في Reference بكتابة معرّف الهدف بأقل عدد من WORD.
Edge Id
- LOCAL الذي هو العنصر الأول في Payload الـEdge هو تصريح Edge Id لذلك الـEdge (Edge). لا يُستخدم لتصريح Edge Id إلا Identified (
0x005L). - LOCAL في سائر مواضع Payload الـEdge هو ذِكر. يُكتب هدف هذا المستند LOCAL عند كل ذِكر. لا يوجد رمز إشاري مستقل يشير إلى هدف هذا المستند.
تخصيص المعرّفات
- المعرّف عدد صحيح يخصصه المُرمِّز. لا معنى لحجم الرقم ولا لترتيب التخصيص سوى التماثل.
- UNIQUE (إلزامي). في المستند الواحد لا يشير LOCAL ID واحد إلا إلى هدف واحد. يُصرَّح بـEdge Id مرة واحدة فقط في كل مستند (Edge في HEAD وEdge في BODY يتشاركان فضاء أرقام واحدًا). إذا صرّح أكثر من Edge بالـEdge Id نفسه فهو invalid.
- AUTO INCREMENT (موصى به). يُخصَّص المعرّف الجديد بأكبر معرّف خُصِّص حتى الآن في ذلك المستند + 1، ويُترك متزايدًا بترتيب المستند. وكذلك عبر الإصدارات (يُنشأ الجديد بقيمة أكبر من المعرّف المحذوف). هذا توصية فقط وليس شرط صلاحية، والمستند غير المتزايد valid أيضًا. لا يعتمد المفكّك على حجم المعرّف ولا على تتابعه.
- لا يُخصَّص المعرّف
0. لا يشير إلى أي هدف ولا يُستخدم Edge Id. تُخصَّص معرّفات الأهداف من1. - يُشار إلى المستند، داخل المستند أو خارجه، بـDOC-POINTER واحد فقط (يشير المستند إلى نفسه بـDOC-POINTER لـ
DOC-IDالخاص به). ويمكن أيضًا إلحاقBINDوLABELوEdge الحكم بالمستند. - يُشار إلى الـIssuer نفسه بـISSUER-POINTER. معرّف المستند
0هو مستند فهرس تعريف مصطلحات الـIssuer. - الـCodec التي تعطي
0في موضع المكوّن معنى (REF في TOULMIN و«لا شيء» في Edge التنفيذ، و«المستند كله» في Target في SOURCE الخاص بـHEAD) تتبع قاعدة تلك الـCodec. هذا اتفاق داخل تلك الـCodec يختلف عن علامة موضع. - المعرّف المخصَّص مرة لا يُعاد استخدامه في المستند نفسه.
- يُستخدم دائمًا أصغر عرض يمكنه تمثيل القيمة.
التماثل والنطاق
- إذا تساوت القيمة الصحيحة لـLOCAL ID في المستند الواحد فهما الهدف نفسه. عرض الترميز ليس جزءًا من التماثل.
- LOCAL من نوع Identified يمثّل هدفًا محدَّد الهوية. لا يُستخدم للمجهول ولا لغير المحدَّد ولا null ولا sentinel. أما القول إن القيمة موجودة لكنها مجهولة (UNKNOWN-VALUE) أو إنه لا توجد قيمة (NO-VALUE) فيُكتب علامة موضع في الحقل الذي يقبل تلك العلامة.
- LOCAL ID مختلفان هما Reference مختلفان فحسب، ولا يعني ذلك أن الهدفين مختلفان في الواقع.
- لا يُوسَّع تماثل LOCAL خارج المستند. الرقم نفسه في مستند آخر لا صلة له.
- LOCAL من نوع Variable (
0x009L) متغيّر خطابي مسمّى (Variable في Reference).
الدمج
عند دمج عدة مستندات في مستند واحد يُنشأ لكل مستند أصلي جدول تقابل old ID → new ID، ويُعاد تخصيص كل LOCAL ID بمعرّف المستند الجديد وتُستبدل كل الإحالات.
- المعرّفات التي كانت متساوية في المستند الأصلي نفسه يجب أن تبقى متساوية بعد الدمج.
- الرقم نفسه في مستندين أصليين مختلفين لا صلة له، ولا يُدمج تلقائيًا في Reference واحد.
- إذا وُجد LOCAL واحد تعذّر استبداله يُرفض الدمج.
الصلاحية
الترميز أو التخصيص التالي invalid.
- ترميز غير أدنى (non-minimal) بوجود WORD
0x0000في البداية (الاستثناء: القيمة 0 بـWORD واحد0x0000) - أن تكون الـCodec في موضع تصريح Edge Id ليست Identified (
0x005L)، أو يكون المعرّف0 - أن يُخصَّص معرّف واحد لهدفين مختلفين في المستند نفسه
- أن يُصرَّح بالـEdge Id نفسه مرتين أو أكثر في المستند نفسه
مثال
| LOCAL ID | WORD sequence |
|---|---|
| 1 | 0051 0001 |
| 65535 | 0051 FFFF |
| 65536 | 0052 0001 0000 |
| 4294967295 | 0052 FFFF FFFF |
| 1, Variable | 0091 0001 |
صفحات ذات صلة
نص مستند المواصفة
هذا مستند المواصفة 0x00000000/codecs/0x00000050/latest.geul مقروءًا بـgeul show (الأرقام السداسية عشرية بأحرف كبيرة).
SPEC-VERSION 0x0001
DOC-ID 0x0426000000000000005000000000
BODY
#1 DECLARE 0x0050
#2 FIELD #1 rest
#3 BIND #1 "LOCAL-IDENTIFIED"
#4 BIND #2 "local-id"
ما سبق هو مستند Codec لـLOCAL-IDENTIFIED (0x005L). أما مستندات Codec للأعضاء الآخرين (LOCAL-GENERIC وLOCAL-FREE-CHOICE وLOCAL-UNIVERSAL وLOCAL-VARIABLE) فيختلف فيها فقط Codec ID في DOC-ID وهدف DECLARE والاسم المربوط (BIND) في #1.