פריטערך
שםBIND (BIND במסמך המפרט BIND)
TAG ID0x0A3L
Codec ID0x00000A30
מסמך מפרט0x00000000/codecs/0x00000A30/ (יעד DECLARE‏ 0A30)
קטע5 0101 (Edge של היגד), היסט C בתוך הקטע = 3
KindEdge · משפחה: היגד, קבוצה: הצבעה ושמות
TAG WORD0000 1010 0011 LLLL (000K KKKC CCCC LLLL)
תיאור באינדקסקושרת ל-Subject שם שהמכונה מתאימה אליו (UTF8-TEXT-*). ייחודי בתוך התחום, חייב להתאים במדויק, ואין לו שפה
בצד Hugoedge/bind.md

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

הסדר של FIELD במסמך הוא סדר שדות ה-Payload (מסמך מפרט Codec). ה-Edge Id של Edge אינו מוצהר באמצעות FIELD.

סדרשדה (BIND)FIELDרוחבפורמט מקבל (CODEC)ENUM
1subject#2רשומהכל רשומה (פרט לסמן מקום)
2name#3רשומה0720 UTF8-TEXT-EVEN, ‏0730 UTF8-TEXT-ODD

BIND היא Edge של היגד שקושרת ל-Subject שם שהמכונה מתאימה אליו. Codec‏ 0x0A3L.

זהו מתן שם. השם שבני אדם קוראים (כותרת בכל שפה) הוא תפקידה של LABEL. השם של סמל בתוכנית והשם של דומיין ברשימת ה-Issuer נכתבים באותה רשומה.

פריסה

TAG WORD          0000 1010 0011 LLLL
[Length extension TAG]
Edge Id           רשומת LOCAL Reference
Subject           רשומת Reference אחת, או WORD אחד של TAG של Codec
שם                Value אחד מסוג UTF8-TEXT-*

פירוש ותוקף

  • ה-Subject הוא רשומת Reference שלמה אחת בדיוק. אם הוא LOCAL, זהו יעד של המסמך הזה (סמל וכד’), ואם הוא Reference מצביע, זהו יעד של מסמך אחר. המסמך עצמו הוא DOC-POINTER, וה-Issuer עצמו הוא ISSUER-POINTER.
  • לחלופין, ה-Subject הוא WORD אחד של TAG של Codec (רק Kind ו-Codec, ‏LLLL = 0, בלי Payload). זו אינה רשומה עם Payload ריק, אלא הקוד הישיר עצמו, כלומר מסמך המפרט שלו (Codec של Issuer GEUL‏ 0x0000<TAG>) (מסמך מפרט Codec, DECLARE). למשל: 0B80 הוא PUBLICATION. Codec בפורמט Issuer אינו מוזכר בצורה זו.
  • רשומות אחרות (Value וכד’) אינן יכולות להיות Subject. ה-FIELD במסמך המפרט של BIND מצהיר על ה-Subject רק ברוחב 0 (רשומה), ולכן אילוץ זה הוא כלל של גוף ה-BIND.
  • השם הוא Value אחד בדיוק מסוג UTF8-TEXT. אין לו שפה והוא אינו מנורמל. שמות הם אותו שם רק אם הבתים זהים.
  • תחום השם הוא המסמך שמכיל את ה-BIND. במסמך אחד לא קושרים אותו שם ל-Subject שונים.
  • אפשר לקשור ל-Subject אחד כמה שמות (כינוי, שם ישן). אם המסמך לא קבע אחרת, ה-BIND האחרון הוא השם המייצג.
  • רשומות אחרות מצביעות על יעד באמצעות LOCAL ID ולא באמצעות שם. השם משמש להתאמה עם החוץ (פונקציות מארח, קלט כתובת, בני אדם).
  • התווים המותרים בשם נקבעים לפי השימוש. שם דומיין ברשימת Issuer כפוף לכללי הדומיין (אותיות קטנות, IDNA) (כתובת פרסום ורשימת גרסאות).
  • ברשימת גרסאות לא מציבים BIND. אין כתובת של שם מסמך (כתובת פרסום ורשימת גרסאות).

אורך

סה"כ = 1 + N_len + N_id + N_subject + N_name WORD

דוגמה (לא נורמטיבית)

סמל בתוכנית: Edge Id הוא 0003, ה-Subject הוא LOCAL 7, השם הוא main.

  • השם main הוא 4 בתים (זוגי), ולכן 0722 6D61 696E, כלומר 3 WORD.
  • ה-Edge הוא TAG 1 + Edge Id 2 + Subject 2 + שם 3 = 8 WORD, וה-TAG הוא 0A37.
0A37 0051 0003 0051 0007 0722 6D61 696E

דפים קשורים

טקסט מקורי של מסמך המפרט

כך נראה מסמך המפרט 0x00000000/codecs/0x00000A30/latest.geul כשהוא נקרא באמצעות geul show (ספרות הקסדצימליות באותיות גדולות).

SPEC-VERSION 0x0001
DOC-ID 0x04260000000000000A3000000000
BODY
#1 DECLARE 0x0A30
#2 FIELD #1 record
#3 FIELD #1 record
#4 BIND #1 "BIND"
#5 BIND #2 "subject"
#6 BIND #3 "name"
#7 CODEC #3 0x0720
#8 CODEC #3 0x0730