PREDICATE-DECLARE הוא Codec של TOULMIN שמצהיר על פרדיקט (ביטוי פסק דין). הפריסה היא EXPR. EXPR היא פריסה שכותבת ביטויי תנאי של TANGEUL Rules. עץ ביטוי התנאי נפרש בסדר קדם (pre-order), ומחרוזות בתוך הביטוי מוצבעות בטבלת תוויות בתוך הרשומה. לכן הרשומה שלמה בפני עצמה, ללא רשומת TEXT.

פריטערך
שםPREDICATE-DECLARE (BIND PREDICATE-DECLARE במסמך המפרט)
TAG ID0x101L
Codec ID0x00001010
מסמך מפרט0x00000000/codecs/0x00001010/ (יעד DECLARE 1010)
קטע8 1000 (Edge TOULMIN), היסט C בתוך הקטע = 1
KindEdge · משפחה: TOULMIN, קבוצה: הצהרה, פריסה: EXPR
TAG WORD0001 0000 0001 LLLL (000K KKKC CCCC LLLL)
תיאור באינדקסהצהרת פרדיקט. פונקציית פסק דין וביטוי, קריטריון שיפוט (Spec), חוזה עובדות (Ground)
בצד Hugoedge/toulmin/expr.md

פריסה

ID                     רשומת LOCAL Reference (Edge Id)
מספר צמתים 1 WORD       המספר הכולל של רשומות הביטוי
מספר תוויות 1 WORD
תווית × מספר תוויות     רשומת UTF8-TEXT Value
רשומת ביטוי × מספר צמתים  בסדר קדם
  • תווית היא מחרוזת כגון שם שדה, ערך מחרוזת, צעד בנתיב או שם פונקציה. מחרוזת ריקה גם היא תווית. רשומת ביטוי מצביעה על תווית באמצעות אינדקס (1 WORD) שמתחיל ב-0.
  • רשומת ביטוי מניחה את האב ואחריו את הילדים לפי הסדר (סדר קדם). מספר הילדים של כל רשומה והסדר הזה קובעים עץ יחיד.

רשומת ביטוי

רשומת ביטוי מתחילה ב-WORD כותרת אחד.

כותרת 1 WORD      2 הביטים התחתונים של הסוג (b15–14) | ביט עליון אחד של הסוג (b13) | מספר ילדים 13 ביט (b12–0)

סוג = (b13 << 2) | b15–14.

סוגשםמספר ילדיםאחרי הכותרת
0COMPARE0אופרטור השוואה 1 WORD, תווית שדה 1 WORD, מקום ערך
1LOGICnאופרטור לוגי 1 WORD
2NOT1אין
3EITHERnאין
4EXISTS1אופרטור כימות 1 WORD, אופרנד יעד, תווית שם הקושר 1 WORD
5CALL0תווית כינוי 1 WORD, תווית שם פונקציה 1 WORD
6COMPARE-X0אופרטור השוואה 1 WORD, תווית שדה 1 WORD, סמן שמאלי 1 WORD [+ אופרנד], מקום ערך
7Reserved
  • רשומות הילדים נמשכות אחרי השדות שאחרי הכותרת. הילד של EXISTS הוא תנאי אחד.
  • COMPARE היא השוואה <שדה> <אופרטור> <ערך> ללא אופרנד משני הצדדים. אם יש אופרנד בצד אחד לפחות, משתמשים ב-COMPARE-X.
  • אם הסמן השמאלי של COMPARE-X הוא 1, אופרנד בא אחריו; אם 0, אין אופרנד. כשיש אופרנד שמאלי, תווית השדה היא מחרוזת ריקה.
  • CALL היא קריאה לפונקציית מארח (host function) במקום הפרדיקט. אם הפונקציה שייכת למסמך הזה, תווית הכינוי היא מחרוזת ריקה.

מקום ערך

סוג ערך 1 WORD    0 מספר, 1 מחרוזת, 2 אופרנד
ערך               0: רשומת UNSIGNED-INTEGER Value
                  1: תווית 1 WORD
                  2: אופרנד (רק ב-COMPARE-X)
  • אם מחרוזת הערך זהה בדיוק לכתיב העשרוני הקנוני של מספר שלם אי-שלילי, היא נכתבת כ-UNSIGNED-INTEGER Value. כל ערך אחר נכתב כתווית. כך מחרוזת הערך משוחזרת כפי שהיא.

אופרנד

סוג אופרנד 1 WORD   0 נתיב, 1 הפניית קריטריון, 2 קריאת פונקציה
נתיב, הפניית קריטריון   מספר צעדים 1 WORD + תווית 1 WORD × מספר צעדים
קריאת פונקציה           תווית כינוי 1 WORD + תווית שם פונקציה 1 WORD
  • נתיב הוא נתיב בנתוני הקלט, והפניית קריטריון היא נתיב בקריטריון השיפוט (SPEC) שהוזרק באמצעות with.

קודי אופרטורים

קודאופרטור השוואה
0x0301is empty
0x0302is not empty
0x0303equals
0x0304is in
0x0305is greater than
0x0306is less than
0x0307is at most
0x0308is at least
קודאופרטור לוגי
0x0311and
0x0312or
קודאופרטור כימות
0x0321any

הערכה על קלט לא ידוע

כשהקלט הוא סמן מקום, אופרטורי ההשוואה מוערכים בשלושה ערכים (אמת, שקר, לא מוכרע U). ב-NO-VALUE, is empty אמת ושאר ההשוואות שקר. ב-UNKNOWN-VALUE, is not empty אמת, ואילו equals, is in והשוואות גודל הן U. ב-ABSENT ובהיעדר היגד, כל האופרטורים הם U. האופרטורים הלוגיים פועלים לפי Kleene החזקה בשלושה ערכים, וכשהפרדיקט הוא U פסק הצומת הוא Review. הערכה זו היא ליבה קבועה (TOULMIN).

פירוש ותוקף

  • מספר הצמתים חייב להיות שווה למספר רשומות הביטוי שנפרשו. המיקום שבו נקראה רשומת הביטוי האחרונה חייב להתיישר בדיוק עם סוף הרשומה.
  • אם אינדקס תווית גדול ממספר התוויות או שווה לו, דוחים.
  • מספר הילדים של NOT ושל EXISTS חייב להיות 1.
  • סוג לא מוכר (7), או סוג ערך או סוג אופרנד לא מוכרים, נדחים.
  • מספר הילדים הוא 13 ביט (עד 8191).

מסמך Codec

מסמך ה-Codec מכיל DECLARE (יעד 1010). בפריסת EXPR הערכים הגולמיים הראשונים (מספר צמתים, מספר תוויות) קובעים את מספר החזרות ולכן אי אפשר להצהיר עליהם באמצעות FIELD; הצהרת השדות היא בעיה פתוחה (חזרה ב-DECLARE).

דפים קשורים

נוסח מקור של מסמך המפרט

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

SPEC-VERSION 0x0001
DOC-ID 0x0426000000000000101000000000
BODY
#1 DECLARE 0x1010
#2 BIND #1 "PREDICATE-DECLARE"