| פריט | ערך |
|---|---|
| שם | CODEC (BIND במסמך המפרט CODEC) |
| TAG ID | 0x0BEL |
| Codec ID | 0x00000BE0 |
| מסמך מפרט | 0x00000000/codecs/0x00000BE0/ (יעד DECLARE 0BE0) |
| קטע | 5 0101 (Edge של היגד), היסט C בתוך הקטע = 30 |
| Kind | Edge · משפחה: היגד, קבוצה: אחר |
| TAG WORD | 0000 1011 1110 LLLL (000K KKKC CCCC LLLL) |
| תיאור באינדקס | Kind ו-Codec אחד ששדה מקבל. השדה, WORD היעד (000K KKKC CCCC LLLL, LLLL 0000 מדויק·1111 תו כללי (כל 32 המשבצות של אותו קטע), סמני מקום רק כיעד מדויק 0000·0010·0020). בשדה של רשומה יש כמה (רשימה סגורה), ובשדה של ערך גולמי אחד (אותו Value בלי TAG) |
| בצד Hugo | edge/codec.md |
שדות (מסמך מפרט)
הסדר של FIELD במסמך הוא סדר שדות ה-Payload (מסמך מפרט Codec). ה-Edge Id של Edge אינו מוצהר באמצעות FIELD.
| סדר | שדה (BIND) | FIELD | רוחב | פורמט מקבל (CODEC) | ENUM |
|---|---|---|---|---|---|
| 1 | field | #2 | רשומה | 0050 LOCAL | |
| 2 | target | #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 (למשל: LOCAL0x0050←0x00000050, COORDINATE-EARTH0x0640, UTF8-LANGUAGE-TEXT0x0780). לכן היעד מצביע ישירות על מסמך המפרט של אותו 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. אין להן כימות.
| יעד | סמן | משמעות |
|---|---|---|
0000 | ABSENT | לא נכתב. השדה הוא שדה אופציונלי |
0010 | UNKNOWN-VALUE | לא ידוע. מקבל קביעה שיש ערך |
0020 | NO-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"