פריטערך
שם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 מצהיר המצביע על יעד באמצעות ID שהמסמך הזה הנפיק. הוא מפנה ליעד בתוך המסמך בלי Issuer חיצוני. כדי להצביע מחוץ למסמך, מציבים במסמך את Meta DOC-ID, ומסמך אחר מצביע עליו ב-Reference מכוון.

פריסה

TAG WORD          0000 0000 0101 LLLL      Codec 0x005L~0x009L (Identified 0x005L)
[Length TAG הרחבה]
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: כותבים את ID היעד במספר ה-WORD הקטן ביותר.

Edge Id

  • ה-LOCAL שהוא האיבר הראשון ב-Payload של Edge הוא הצהרת ה-Edge Id של אותו Edge (Edge). ההצהרה על Edge Id משתמשת רק ב-LOCAL מסוג Identified (0x005L).
  • LOCAL בכל מקום אחר ב-Payload של Edge הוא אזכור. יעד המסמך הזה נכתב כ-LOCAL בכל אזכור. אין קוד מכוון נפרד להצבעה על יעד של המסמך הזה.

הקצאת מזהים

  • ה-ID הוא מספר שלם והמקודד מקצה אותו. לגודל המספר ולסדר ההקצאה אין שום משמעות מלבד זהות.
  • UNIQUE (חובה). במסמך אחד, LOCAL ID אחד מצביע על יעד אחד בלבד. Edge Id מוצהר פעם אחת בלבד לכל מסמך (HEAD Edge ו-BODY Edge חולקים מרחב מספרים אחד). אם יותר מ-Edge אחד מצהיר על אותו Edge Id, המסמך invalid.
  • AUTO INCREMENT (המלצה). מקצים ID חדש כערך המרבי של ה-ID שהוקצו עד כה במסמך + 1, כך שיגדלו לפי סדר המסמך. כך גם בין גרסאות (יוצרים חדש בערך הגדול מ-ID שנמחק). זו המלצה בלבד ולא תנאי תקפות, ומסמך שה-ID שלו אינם עולים הוא valid. המפענח אינו נשען על גודל ה-ID או על רציפותו.
  • ID 0 אינו מוקצה. הוא אינו מצביע על שום יעד ואינו משמש כ-Edge Id. ID של יעד מוקצים החל מ-1.
  • מסמך מצביעים עליו, בתוך המסמך או מחוצה לו, רק באמצעות DOC-POINTER אחד (המסמך מצביע על עצמו ב-DOC-POINTER של DOC-ID שלו). אפשר לצרף גם למסמך BIND, LABEL ו-Edge של פסק דין.
  • ה-Issuer עצמו מצביעים עליו ב-ISSUER-POINTER. מסמך ID 0 הוא מסמך האינדקס של הגדרות המונחים של ה-Issuer.
  • Codec שנותן משמעות ל-0 במקום של רכיב (ה«אין» של REF ושל Edge ביצוע ב-TOULMIN, ה«כל המסמך» של Target ב-SOURCE של HEAD) פועל לפי כללי אותו Codec. זו הסכמה בתוך אותו Codec, שונה מסמן מקום.
  • ID שהוקצה פעם אחת אינו נעשה בו שימוש חוזר באותו מסמך.
  • תמיד משתמשים ברוחב המינימלי שמסוגל לייצג את הערך.

זהות והיקף

  • באותו מסמך, ערכים שלמים שווים של LOCAL ID הם אותו יעד. רוחב הקידוד אינו חלק מהזהות.
  • LOCAL מסוג Identified מייצג יעד מזוהה. אין משתמשים בו כאנונימי, כלא-מוגדר, כ-null או כ-sentinel. הדברים «יש ערך אך לא ידוע» (UNKNOWN-VALUE) ו«אין ערך» (NO-VALUE) נכתבים כסמן מקום בשדה שמקבל את הסמן.
  • LOCAL ID שונים הם רק Reference שונים, ואין פירושו שגם היעדים במציאות שונים.
  • אין מרחיבים את זהות ה-LOCAL אל מחוץ למסמך. אותו מספר במסמך אחר אינו קשור.
  • LOCAL מסוג Variable (0x009L) הוא משתנה שיח בעל שם (Reference Variable).

מיזוג

כשממזגים כמה מסמכים לאחד, יוצרים לכל מסמך מקור טבלת התאמה old ID → new ID, מקצים מחדש את כל ה-LOCAL ID ל-ID של המסמך החדש ומחליפים את כל ההפניות.

  • ID שהיו שווים באותו מסמך מקור חייבים להישאר שווים גם אחרי המיזוג.
  • אותו מספר במסמכי מקור שונים אינו קשור, ואין ממזגים אותם אוטומטית ל-Reference אחד.
  • אם נותר LOCAL אחד שלא הוחלף, המיזוג נדחה.

תקפות

הקידודים או ההקצאות הבאים הם invalid.

  • קידוד non-minimal עם WORD מוביל 0x0000 (יוצא מן הכלל: 0x0000 ב-WORD אחד עבור הערך 0)
  • Codec במקום הצהרת Edge Id שאינו Identified (0x005L), או ID השווה ל-0
  • הקצאת ID אחד לשני יעדים שונים בחפיפה באותו מסמך
  • הצהרה על אותו 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 והשם שנקשר ב-#1 (BIND).