פריטערך
שםCODEC (BIND במסמך המפרט CODEC)
TAG ID0x0BEL
Codec ID0x00000BE0
מסמך מפרט0x00000000/codecs/0x00000BE0/ (יעד DECLARE‏ 0BE0)
קטע5 0101 (Edge של היגד), היסט C בתוך הקטע = 30
KindEdge · משפחה: היגד, קבוצה: אחר
TAG WORD0000 1011 1110 LLLL (000K KKKC CCCC LLLL)
תיאור באינדקסKind ו-Codec אחד ששדה מקבל. השדה, WORD היעד (000K KKKC CCCC LLLL, ‏LLLL‏ 0000 מדויק·1111 תו כללי (כל 32 המשבצות של אותו קטע), סמני מקום רק כיעד מדויק 0000·0010·0020). בשדה של רשומה יש כמה (רשימה סגורה), ובשדה של ערך גולמי אחד (אותו Value בלי TAG)
בצד Hugoedge/codec.md

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

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

סדרשדה (BIND)FIELDרוחבפורמט מקבל (CODEC)ENUM
1field#2רשומה0050 LOCAL
2target#4ערך גולמי, WORD אחד

CODEC היא Edge של היגד שמציינת Kind ו-Codec אחד ש-FIELD אחד מקבל. Codec‏ 0x0BEL.

כשם ש-ENUM מצרפת משמעות לערך קוד אחד של שדה ערך גולמי, CODEC מצרפת לשדה פורמט אחד. כל Edge מציינת אחד, ולכן אפשר לציין כמה. הפריסה מובנית במפענח (מסמך מפרט Codec).

פריסה

TAG WORD          0000 1011 1110 LLLL
[Length extension TAG]
Edge Id           רשומת LOCAL Reference
שדה               רשומת LOCAL Reference שמצביעה על Edge של FIELD
יעד               WORD אחד. 000K KKKC CCCC LLLL (LLLL = 0000 מדויק, 1111 תו כללי)

WORD היעד

  • משאירים כמות שהוא את מקום ה-Codec של ה-TAG WORD (הקטע KKKK ו-CCCCC). שלושת הביטים העליונים הם 0. LLLL הוא 0000 (מדויק) או 1111 (תו כללי), וכל ערך אחר הוא invalid.
  • הערך של יעד מדויק (LLLL = 0000) כתוב ב-32 ביט הוא מזהה ה-Codec של אותו Codec (למשל: LOCAL‏ 0x0050 ← 0x00000050, ‏COORDINATE-EARTH‏ 0x0640, ‏UTF8-LANGUAGE-TEXT‏ 0x0780). לכן היעד מצביע ישירות על מסמך המפרט של אותו Codec (מסמך מפרט Codec).
  • גם זוג קודים זוגי-אי-זוגי (טקסט ורצף בתים) מצוין בקוד מדויק. כדי לקבל גם זוגי וגם אי-זוגי מציבים את שניהם. אין כלל שמפרש זוג יחד (יש קודים סמוכים שאינם זוג, כמו NUMERIC‏ 0x064L/0x065L).

תו כללי (LLLL = 1111)

  • כש-LLLL = 1111, מתקבל הקטע KKKK כולו (32 משבצות) של WORD היעד, בלי קשר לערך של C. בתוך אותו קטע, למשמעות אין חשיבות לערך C. בודקים רק אם הקטע של היעד והקטע של הרשומה זהים. לא מקבלים מעבר לקטע.
  • כש-LLLL = 1111, מומלץ להשתמש במשבצת הראשונה של הקטע (C = 0). זו המלצה ולא כפייה. גם C אחר באותו קטע תקף.
  • אם ה-Kind משתרע על כמה קטעים, מונים CODEC לכל קטע.
יעדמשמעות
000F·020F·040Fכל Reference (קטעים 0~2, כולל REFERENCE-ISSUER)
060F·080Fכל Value (קטעים 3 ו-4, כולל VALUE-ISSUER)
0A0F·0C0F·0E0F·100F·120F·140F·160F·180F·1A0Fכל Edge (קטעים 5~13, כולל EDGE-ISSUER)
1C0F·1E0Fכל Meta (קטעים 14 ו-15)
  • סמני המקום של Reference (‏0x000L~0x002L) אינם מתאימים ל-LLLL = 1111 (‏000F אינו מקבל ABSENT·UNKNOWN-VALUE·NO-VALUE). מנגד, גם בקטע שבו המשבצת הראשונה הוקצתה, כמו Value ‏0x060L (BOOL) ו-Edge ‏0x0A0L (REFERENCE-NODE), LLLL = 1111 כולל אותה (כדי לקבל רק BOOL, ‏0600 עם LLLL = 0000).
  • יעד עם LLLL = 1111 אינו מצביע על מסמך מפרט.
  • חוסר תלות בכימות, או קבוצה, נכתבים רק על ידי מניית CODEC (‏LLLL = 0000). למשל: WIKIDATA-QID בלי תלות בכימות הוא חמישה: 0140, ‏0150, ‏0160, ‏0170, ‏0180.
  • בקודים של מערכת ה-5Q של Reference כלול הכימות. היעד מציין גם את הכימות במדויק. כדי לקבל כמה Quantifier-ים, מציבים כמה CODEC. הכימות של REFERENCE-ISSUER נקבע על ידי מסמכי ה-Issuer.

סמן מקום (יעד 0000, 0010, 0020)

סמן מקום הוא קבוצה של רשומות בנות WORD אחד שהוקצו בשלוש המשבצות הראשונות 0x000L~0x002L של קטע 0 של Reference. אין להן כימות.

יעדסמןמשמעות
0000ABSENTלא נכתב. השדה הוא שדה אופציונלי
0010UNKNOWN-VALUEלא ידוע. מקבל קביעה שיש ערך
0020NO-VALUEאין. מקבל קביעה שאין ערך
  • כלל קבלה: סמן תקף רק אם אותו WORD מופיע ברשימת ה-CODEC של השדה כיעד מדויק. תו כללי, ושדה של רשומה בלי CODEC (“כל רשומה”), אינם מקבלים סמן. סמן במקום של רשומה ב-HEAD או ב-BODY, או במקום של Edge Id, הוא invalid.
  • רשימה שיש בה רק יעדי סמן (תמיד סמן) היא invalid (הכללה של כלל הרשימה שיש בה רק 0000). משתמשים בה יחד עם יעד LLLL = 1111 או יעד מדויק (‏000F·020F·040F + 0000 = כל Reference או השמטה).
  • בשדה של ערך גולמי אי אפשר להציב יעד סמן. לערך גולמי אין TAG והרוחב קבוע, ואין מקום לסמן של WORD אחד.
  • המשמעות של הסמן נקבעת על ידי מפרט ה-Codec שמקבל אותו.

שדה אופציונלי (יעד 0000)

  • אם ברשימת ה-CODEC של שדה של רשומה יש יעד 0000, השדה הוא שדה אופציונלי. כשמשמיטים אותו, כותבים במקומו WORD אחד 0x0000. הרשומה הזו בת WORD אחד היא סמן המקום ABSENT (לא נכתב).
  • 0x0000 הוא Reference, ‏Codec ‏0x000L (Reserved), ‏LLLL = 0000 (סה"כ WORD אחד). הוא אינו מתנגש ברשומה אחרת, ומפענח שאינו מכיר את המפרט מדלג עליו כרשומה בת WORD אחד.
  • גם שדה אופציונלי תופס תמיד את מקומו. כשמשמיטים אותו חייבים לכתוב 0x0000 ולא להשאיר את המקום ריק (גם בשדות אחרונים). לכן יש לרשומה אחת רק ייצוג אחד, והפירוק נקבע רק לפי המיקום. אין הגבלה על המיקום והמספר של שדות אופציונליים, או על חפיפה של הרשימה עם שדות אחרים.
  • ABSENT תקף רק במקום של שדה אופציונלי. 0x0000 במקום של רשומה ב-HEAD או ב-BODY, במקום של שדה חובה, או במקום של Edge Id, הוא invalid.
  • השמטה אינה “אין ערך” אלא “לא נכתב”. לא נקבע דבר על העולם. “אין ערך” נכתב כ-NO-VALUE (‏0020). מה פירוש ההשמטה (למשל: אם אין יעד ב-TAG, זו הגרסה הזו) נקבע במפרט של כל פורמט.

פירוש ותוקף

  • השדה הוא Edge של FIELD באותו מסמך. לא מציבים אותו יעד פעמיים בשדה אחד.
  • שדה של רשומה (רוחב 0): אם אין CODEC, מקבלים כל רשומה פרט לסמן מקום. אם יש אחד או יותר, זו רשימה סגורה. ה-Kind וה-Codec של הרשומה בשדה (ב-Reference, כולל Quantifier) חייבים להיות אחד מאלה שברשימה, ואם לא, הרשומה אינה עומדת במפרט. זה שונה מ-ENUM שהיא רשימה פתוחה.
  • שדה של ערך גולמי (רוחב n ≥ 1, או שאר 0xFFFF): מציבים ב-CODEC רק יעד מדויק אחד (בלי תו כללי). הערך הגולמי הוא ה-Payload של אותו Value בלי ה-TAG. ה-Kind וה-Codec באים מ-CODEC, וה-Length מרוחב ה-FIELD. בקוד זוגי-אי-זוגי, הקוד שצוין קובע אם מספר הבתים זוגי או אי-זוגי. אם הערך הגולמי אינו עומד בכללי אותו Value (כולל האורך), הרשומה אינה עומדת במפרט.
  • סמן מקום נבדק מול יעדים מדויקים ברשימה בלבד. אם במקום של שדה אופציונלי (יעד 0000) בא 0x0000, זו השמטה. רשומות אחרות נבדקות מול הרשימה בלי יעדי הסמן.
  • בשדה של ערך גולמי אפשר להציב CODEC ו-ENUM יחד. CODEC הוא הפורמט, ו-ENUM הוא השם של ערך הקוד (למשל: rank כ-UNSIGNED-INTEGER, ועם 0·1·2 כ-ENUM).
  • אפשר לתת שם ל-Edge Id של CODEC באמצעות BIND, אך אין חובה.
  • שדה “Reference או Value” נכתב בחמישה CODEC (‏000F, ‏020F, ‏040F, ‏060F, ‏080F).

אורך

סה"כ = 1 + N_len + N_id + N_field + 1 WORD   (6 WORD כש-Edge Id והשדה הם LOCAL ID בן WORD אחד)

דוגמה

במסמך המפרט של LABEL, ‏0x00000000/codecs/0x00000A40/, שדה ה-Object (FIELD‏ #3) מקבל UTF8-LANGUAGE-TEXT (זוגי ואי-זוגי) ו-LOCAL. ה-Edge Id-ים הם 7~9.

0BE5 0051 0007 0051 0003 0780
0BE5 0051 0008 0051 0003 0790
0BE5 0051 0009 0051 0003 0050
  • ה-TAG הוא 0BE5 (Edge, ‏Codec ‏0x0BEL, ‏LLLL = 0101, ‏6 WORD), ה-Edge Id הוא 0051 0007, השדה הוא 0051 0003, והיעד הוא 0780.

דפים קשורים

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

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

SPEC-VERSION 0x0001
DOC-ID 0x04260000000000000BE000000000
BODY
#1 DECLARE 0x0BE0
#2 FIELD #1 record
#3 CODEC #2 0x0050
#4 FIELD #1 0x0001
#5 BIND #1 "CODEC"
#6 BIND #2 "field"
#7 BIND #4 "target"