EXTERNAL-POINTER هو Reference إشاري يشير إلى LOCAL ID في مستند استُورد بـIMPORT-DOC في HEAD.

البندالقيمة
الاسمEXTERNAL-POINTER-1WORD (حزمة 5Q. اسم كل رمز في جدول الأعضاء أدناه)
TAG ID0x020L~0x024L
القسم1 0001 (Reference EXTERNAL)، الإزاحة داخل القسم C = 0~4
KindReference · التصنيف: إشاري
جهة Hugoreference/external-pointer.md (تتناول تلك الصفحة أيضًا EXTERNAL-POINTER-2WORD وEXTERNAL-POINTER-4WORD)

الأعضاء

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

TAG IDالاسمالتكميمCodec IDمستند المواصفةTAG WORD
0x020LEXTERNAL-POINTER-1WORD-IDENTIFIEDIdentified0x000002000x00000000/codecs/0x00000200/0000 0010 0000 LLLL
0x021LEXTERNAL-POINTER-1WORD-GENERICGeneric0x000002100x00000000/codecs/0x00000210/0000 0010 0001 LLLL
0x022LEXTERNAL-POINTER-1WORD-FREE-CHOICEFree-choice0x000002200x00000000/codecs/0x00000220/0000 0010 0010 LLLL
0x023LEXTERNAL-POINTER-1WORD-UNIVERSALUniversal0x000002300x00000000/codecs/0x00000230/0000 0010 0011 LLLL
0x024LEXTERNAL-POINTER-1WORD-VARIABLEVariable0x000002400x00000000/codecs/0x00000240/0000 0010 0100 LLLL

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

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

الترتيبالحقل (BIND)FIELDالعرضالصيغة المقبولة (CODEC)ENUM
1import-id#2قيمة خام 1 WORD
2target-id#3قيمة خام متبقية (0xFFFF)

EXTERNAL-POINTER هو Reference إشاري يشير إلى LOCAL ID في مستند استُورد بـIMPORT-DOC في HEAD.

التخطيط

TAG WORD          0000 001C CCCC LLLL      Codec 0x020L~0x02EL (القسم 1)
[TAG الامتداد Length]
IMPORT ID         العرض الذي تحدده Codec (1/2/4 WORD)
معرّف الهدف       كل ما تبقى. LOCAL ID في المستند المستورد، بأقصر عرض
Codec (Identified, Generic, Free-choice, Universal, Variable)الاسمعرض IMPORT ID
0x020L~0x024LEXTERNAL-POINTER-1WORD1 WORD
0x025L~0x029LEXTERNAL-POINTER-2WORD2 WORD
0x02AL~0x02ELEXTERNAL-POINTER-4WORD4 WORD
  • يتحدد العرض برقم المنظومة: إذا كان (رقم المنظومة − 6) (أي C / 5 للإزاحة داخل القسم C) يساوي 0 أو 1 أو 2 فالعرض 1 أو 2 أو 4 WORD. والتكميم هو C % 5.

  • تُستخدم أضيق Codec تتسع لقيمة IMPORT ID.

  • IMPORT ID هو القيمة التي خصّصها IMPORT-DOC في هذا المستند. لا يُكتب Issuer في EXTERNAL-POINTER. يُؤخذ الـIssuer ومعرّف المستند من ذلك IMPORT-DOC. والإصدار أيضًا يحدده ذلك IMPORT-DOC (مثبَّت أو الأحدث).

  • إذا كان LOCAL ID في المستند المستورد واحدًا فهو الهدف نفسه، سواء كُتب LOCAL داخل ذلك المستند أو EXTERNAL-POINTER هنا.

  • في حالة Variable يكون متغير LOCAL في المستند المستورد.

الصلاحية

  • يكون invalid إذا لم يوجد في هذا المستند IMPORT-DOC يخصص IMPORT ID ذاك.
  • إذا كان IMPORT ID يتسع في Codec أضيق واستُخدمت أوسع رُفض لأنه non-minimal.
  • يكون invalid إذا كان معرّف الهدف 0. يُشار إلى المستند المستورد نفسه بـDOC-POINTER.
  • يُمنع وجود WORD 0x0000 في بداية معرّف الهدف.

مثال

الهدفWORD sequence
LOCAL 5 لـIMPORT ID 10202 0001 0005
LOCAL 65536 لـIMPORT ID 10203 0001 0001 0000
LOCAL 5 لـIMPORT ID 700000253 0001 1170 0005

صفحات ذات صلة

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

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

SPEC-VERSION 0x0001
DOC-ID 0x0426000000000000020000000000
BODY
#1 DECLARE 0x0200
#2 FIELD #1 0x0001
#3 FIELD #1 rest
#4 BIND #1 "EXTERNAL-POINTER-1WORD-IDENTIFIED"
#5 BIND #2 "import-id"
#6 BIND #3 "target-id"

ما سبق هو مستند Codec لـEXTERNAL-POINTER-1WORD-IDENTIFIED (0x020L). أما مستندات Codec للأعضاء الآخرين (EXTERNAL-POINTER-1WORD-GENERIC وEXTERNAL-POINTER-1WORD-FREE-CHOICE وEXTERNAL-POINTER-1WORD-UNIVERSAL وEXTERNAL-POINTER-1WORD-VARIABLE) فيختلف فيها فقط Codec ID في DOC-ID وهدف DECLARE والاسم المربوط (BIND) في #1.