פריטערך
שםENUM (BIND במסמך המפרט ENUM)
TAG ID0x0BDL
Codec ID0x00000BD0
מסמך מפרט0x00000000/codecs/0x00000BD0/ (יעד DECLARE‏ 0BD0)
קטע5 0101 (Edge של היגד), היסט C בתוך הקטע = 29
KindEdge · משפחה: היגד, קבוצה: אחר
TAG WORD0000 1011 1101 LLLL (000K KKKC CCCC LLLL)
תיאור באינדקסערך קוד אחד של שדה ערך גולמי. השדה, ערך הקוד
בצד Hugoedge/enum.md

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

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

סדרשדה (BIND)FIELDרוחבפורמט מקבל (CODEC)ENUM
1field#2רשומה0050 LOCAL
2code#3שאר הערך הגולמי (0xFFFF)

ENUM היא Edge של היגד שמצרפת משמעות לערך קוד אחד של שדה ערך גולמי. Codec‏ 0x0BDL.

יחד עם FIELD, זהו אוצר המילים לכתיבת מפרט Codec. הפריסה מובנית במפענח (מסמך מפרט Codec).

פריסה

TAG WORD          0000 1011 1101 LLLL
[Length extension TAG]
Edge Id           רשומת LOCAL Reference
שדה               רשומת LOCAL Reference שמצביעה על Edge של FIELD
ערך קוד           ערך גולמי. מספר WORD כמו הרוחב של אותו FIELD

פירוש ותוקף

  • השדה חייב להיות FIELD של ערך גולמי (רוחב n ≥ 1). לא מצרפים ENUM לשדה של רשומה. משמעות הרשומה נקבעת על ידי ה-Codec של אותה רשומה.
  • ערך הקוד הוא בדיוק ברוחב ה-FIELD. הגבולות נבדקים לפי ה-Length של רשומת ה-ENUM.
  • לא מצהירים על אותו ערך קוד פעמיים באותו שדה.
  • שם ערך הקוד נקשר ל-Edge Id של ה-ENUM באמצעות BIND. כל UTF8-TEXT שמצורף ל-DECLARE, FIELD, ENUM ו-CODEC נעשה באמצעות BIND, ולא מצרפים אותו באמצעות Edge אחרת כמו LABEL.
  • ערך קוד שלא הוצהר אינו שגיאה. המציג מציג אותו כערך גולמי. אם לסגור את הערכים המותרים, זה עניין של מפרט ה-Codec, ובאוצר המילים הנוכחי אין סימון לסגירה.

אורך

סה"כ = 1 + N_len + N_id + N_field + n WORD

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

בשדה קטגוריית הסיבה (FIELD‏ #4, ערך גולמי של WORD אחד) במסמך המפרט של TOMBSTONE מצהירים על הקוד 0x0001. ה-Edge Id הוא 10. השם נקשר בנפרד באמצעות BIND. טבלת הקודים של קטגוריית הסיבה טרם נקבעה, ולכן ערך הקוד הוא דוגמה.

  • TAG 1 + Edge Id 2 + שדה 2 + ערך קוד 1 = 6 WORD, ‏LLLL = 0101.
0BD5 0051 000A 0051 0004 0001

במסמך המפרט של TRIPLE מציבים שלושה ENUM (‏0·1·2) בשדה Rank (FIELD‏ #5) וקושרים אותם ב-BIND ל-normal·preferred·deprecated (TRIPLE).

דפים קשורים

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

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

SPEC-VERSION 0x0001
DOC-ID 0x04260000000000000BD000000000
BODY
#1 DECLARE 0x0BD0
#2 FIELD #1 record
#3 FIELD #1 rest
#4 BIND #1 "ENUM"
#5 BIND #2 "field"
#6 BIND #3 "code"
#7 CODEC #2 0x0050