EXTERNAL-POINTER הוא Reference מכוון המצביע על LOCAL ID של מסמך שיובא באמצעות IMPORT-DOC ב-HEAD.

פריטערך
שםEXTERNAL-POINTER-2WORD (קבוצת 5Q. שמות הקודים בטבלת החברים להלן)
TAG ID0x025L~0x029L
קטע1 0001 (Reference EXTERNAL), היסט C בתוך הקטע = 5~9
KindReference · סיווג: מכוון
צד Hugoreference/external-pointer.md (הדף שם עוסק גם ב-EXTERNAL-POINTER-1WORD ו-EXTERNAL-POINTER-4WORD)

חברים

דף זה עוסק בערכת 5Q שלמה, חמישה קודים יחד. הכימות הוא ההיסט בתוך הקטע C % 5 (Reference). לכל קוד יש מסמך Codec אחד. השדות בחמשת מסמכי ה-Codec זהים, ורק יעד ה-DECLARE והשם (BIND) שונים.

TAG IDשםכימותCodec IDמסמך מפרטTAG WORD
0x025LEXTERNAL-POINTER-2WORD-IDENTIFIEDIdentified0x000002500x00000000/codecs/0x00000250/0000 0010 0101 LLLL
0x026LEXTERNAL-POINTER-2WORD-GENERICGeneric0x000002600x00000000/codecs/0x00000260/0000 0010 0110 LLLL
0x027LEXTERNAL-POINTER-2WORD-FREE-CHOICEFree-choice0x000002700x00000000/codecs/0x00000270/0000 0010 0111 LLLL
0x028LEXTERNAL-POINTER-2WORD-UNIVERSALUniversal0x000002800x00000000/codecs/0x00000280/0000 0010 1000 LLLL
0x029LEXTERNAL-POINTER-2WORD-VARIABLEVariable0x000002900x00000000/codecs/0x00000290/0000 0010 1001 LLLL

שדות (מסמך מפרט)

סדר ה-FIELD במסמך הוא סדר שדות ה-Payload (מסמך מפרט של Codec).

סדרשדה (BIND)FIELDרוחבפורמט מתקבל (CODEC)ENUM
1import-id#2ערך גולמי 2 WORD
2target-id#3ערך גולמי לשארית (0xFFFF)

EXTERNAL-POINTER הוא Reference מכוון המצביע על LOCAL ID של מסמך שיובא באמצעות IMPORT-DOC ב-HEAD.

פריסה

TAG WORD          0000 001C CCCC LLLL      Codec 0x020L~0x02EL (קטע 1)
[Length TAG הרחבה]
IMPORT ID         ברוחב שנקבע ב-Codec (1/2/4 WORD)
ID יעד            כל השאר. 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 של המסמך הזה הקצה. ב-EXTERNAL-POINTER אין כותבים Issuer. ה-Issuer ו-ID המסמך נלקחים מאותו IMPORT-DOC. גם הגרסה נקבעת על ידי אותו IMPORT-DOC (קבועה או עדכנית).

  • אם זה אותו LOCAL ID של המסמך שיובא, הוא אותו יעד, בין שנכתב בתוך אותו מסמך כ-LOCAL ובין שנכתב כאן כ-EXTERNAL-POINTER.

  • ב-Variable זהו משתנה LOCAL של המסמך שיובא.

תקפות

  • אם במסמך הזה אין IMPORT-DOC שהקצה את ה-IMPORT ID הזה, זה invalid.
  • אם ה-IMPORT ID נכנס ב-Codec צר יותר אך נעשה שימוש ב-Codec רחב, נדחה כ-non-minimal.
  • אם ID היעד הוא 0, זה invalid. המסמך שיובא עצמו מצביעים עליו ב-DOC-POINTER.
  • WORD מוביל 0x0000 ב-ID היעד אסור.

דוגמה

יעד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/0x00000250/latest.geul כשקוראים אותו ב-geul show (ספרות הקסדצימליות באותיות גדולות).

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

למעלה מסמך ה-Codec של EXTERNAL-POINTER-2WORD-IDENTIFIED (0x025L). במסמכי ה-Codec של שאר החברים (EXTERNAL-POINTER-2WORD-GENERIC, EXTERNAL-POINTER-2WORD-FREE-CHOICE, EXTERNAL-POINTER-2WORD-UNIVERSAL, EXTERNAL-POINTER-2WORD-VARIABLE) שונים רק ה-Codec ID שב-DOC-ID, יעד ה-DECLARE והשם שנקשר ב-#1 (BIND).