פריטערך
שםFIELD (BIND במסמך המפרט FIELD)
TAG ID0x0BCL
Codec ID0x00000BC0
מסמך מפרט0x00000000/codecs/0x00000BC0/ (יעד DECLARE‏ 0BC0)
קטע5 0101 (Edge של היגד), היסט C בתוך הקטע = 28
KindEdge · משפחה: היגד, קבוצה: אחר
TAG WORD0000 1011 1100 LLLL (000K KKKC CCCC LLLL)
תיאור באינדקסשדה אחד ב-Payload. ה-DECLARE שאליו הוא שייך, הרוחב: רשומה (ה-Length של ה-TAG) או ערך גולמי של n WORD
בצד Hugoedge/field.md

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

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

סדרשדה (BIND)FIELDרוחבפורמט מקבל (CODEC)ENUM
1declare#2רשומה0050 LOCAL
2width#3ערך גולמי, WORD אחד0x0000 record, ‏0xFFFF rest

FIELD היא Edge של היגד שמצהירה על שדה אחד ב-Payload של Codec. Codec‏ 0x0BCL.

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

פריסה

TAG WORD          0000 1011 1100 LLLL
Edge Id           רשומת LOCAL Reference
DECLARE           רשומת LOCAL Reference. ה-Edge של DECLARE שהשדה הזה שייך אליו
רוחב              WORD אחד. 0 = רשומה, n (1~65534) = ערך גולמי של n WORD, ‏0xFFFF = שאר הערך הגולמי

פירוש ותוקף

  • ה-DECLARE מצביע על Edge של DECLARE באותו מסמך. FIELD אחד שייך ל-DECLARE אחד בלבד. הסדר אינו נכתב בנפרד, והוא הסדר שבו רשומות FIELD מונחות במסמך.
  • מסמך המפרט של FIELD מצהיר על ה-DECLARE כשדה ברוחב 0 (רשומה) עם CODEC‏ 0050 (LOCAL). לכן בגרף של המציג הוא מצויר כחיבור FIELD ← DECLARE.
  • רוחב 0 הוא שדה של רשומה. הוא מתחיל ב-TAG WORD ונקרא לפי ה-Length של אותו TAG (כללי הפירוש של DECLARE).
  • רוחב n (1~65534) הוא שדה של ערך גולמי. הוא תמיד בדיוק n WORD.
  • רוחב 0xFFFF הוא שאר הערך הגולמי. מציבים רק אחד ב-DECLARE, ואפשר בהתחלה, באמצע או בסוף. הרוחב הוא ה-WORD שנותרו לפי ה-Length של ה-TAG של הרשומה החיצונית פחות רוחב השדות שאחריו. לכן כל השדות אחרי שדה השאר חייבים להיות ערכים גולמיים ברוחב קבוע (את סוף הרשומה אפשר לדעת רק בקריאה מההתחלה). אפשר שיהיה 0 WORD. לא מצרפים ENUM.
  • ה-Kind וה-Codec ששדה מקבל נקבעים באמצעות CODEC. שדה של רשומה בלי CODEC מקבל כל רשומה, ואם יש, חייב להיות אחד מהם. אם מציבים CODEC אחד בשדה של ערך גולמי, הערך הגולמי מפורש כאותו Value בלי ה-TAG.
  • שם השדה נקשר ל-Edge Id של ה-FIELD באמצעות BIND (למשל: doc, ‏hash). כל UTF8-TEXT שמצורף ל-DECLARE, FIELD, ENUM ו-CODEC נעשה באמצעות BIND, ולא מצרפים אותו באמצעות Edge אחרת כמו LABEL.
  • משמעות ערכי הקוד של שדה ערך גולמי מצורפת באמצעות ENUM.
  • שדה שמצביע על צומת אחר בגרף אינו מסומן בנפרד. אם שדה של רשומה הוא Reference, זה החיבור.

אורך

סה"כ = 1 + 2 + 2 + 1 WORD   (כש-Edge Id ו-DECLARE הם LOCAL בני WORD אחד)

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

  • שדה של רשומה: Edge Id הוא 7, ‏DECLARE‏ #1, רוחב 0. TAG 1 + Edge Id 2 + DECLARE 2 + רוחב 1 = 6 WORD. כדי שיקבל רק LOCAL, ראו את הדוגמה של CODEC.
0BC5 0051 0007 0051 0001 0000
  • לשדה של ערך גולמי כמו hash תוכן, ראו את הדוגמה של DECLARE.

דפים קשורים

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

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

SPEC-VERSION 0x0001
DOC-ID 0x04260000000000000BC000000000
BODY
#1 DECLARE 0x0BC0
#2 FIELD #1 record
#13 CODEC #2 0x0050
#3 FIELD #1 0x0001
#5 ENUM #3 0x0000
#6 ENUM #3 0xFFFF
#7 BIND #1 "FIELD"
#8 BIND #2 "declare"
#9 BIND #3 "width"
#11 BIND #5 "record"
#12 BIND #6 "rest"