البندالقيمة
الاسمLOCAL (حزمة 5Q. اسم كل رمز في جدول الأعضاء أدناه)
TAG ID0x005L~0x009L
القسم0 0000 (كيان Reference)، الإزاحة داخل القسم C = 5~9
KindReference · التصنيف: تصريح
جهة Hugoreference/local.md

الأعضاء

تتناول هذه الصفحة منظومة 5Q واحدة، أي خمسة رموز معًا. التكميم هو الإزاحة داخل القسم C % 5 (Reference). لكل رمز مستند Codec واحد. حقول مستندات Codec الخمسة واحدة، ويختلف فقط هدف DECLARE والاسم (BIND).

TAG IDالاسمالتكميمCodec IDمستند المواصفةTAG WORD
0x005LLOCAL-IDENTIFIEDIdentified0x000000500x00000000/codecs/0x00000050/0000 0000 0101 LLLL
0x006LLOCAL-GENERICGeneric0x000000600x00000000/codecs/0x00000060/0000 0000 0110 LLLL
0x007LLOCAL-FREE-CHOICEFree-choice0x000000700x00000000/codecs/0x00000070/0000 0000 0111 LLLL
0x008LLOCAL-UNIVERSALUniversal0x000000800x00000000/codecs/0x00000080/0000 0000 1000 LLLL
0x009LLOCAL-VARIABLEVariable0x000000900x00000000/codecs/0x00000090/0000 0000 1001 LLLL

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

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

الترتيبالحقل (BIND)FIELDالعرضالصيغة المقبولة (CODEC)ENUM
1local-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..655352 WORD0x0051
65536..2^32-13 WORD0x0052
2^32..2^48-14 WORD0x0053
2^48..2^64-15 WORD0x0054
  • الـ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 IDWORD sequence
10051 0001
655350051 FFFF
655360052 0001 0000
42949672950052 FFFF FFFF
1, Variable0091 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.