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)
[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/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 והשם שנקשר ב-#1 (BIND).