antlr4 - מקוון בענן

תָכְנִית:

שֵׁם

ANTLR - כלי נוסף לזיהוי שפה, גרסה 4

תַקצִיר

antlr4 [אפשרויות] file.g4 [ file2.g4 file3.g4 ...]

תיאור

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

אפשרויות

-o outdir
ציין את ספריית הפלט שבה נוצר כל הפלט.

ANTLR יוצר קבצי פלט בספרייה הנוכחית כברירת מחדל. אפשרות זו
מציין את ספריית הפלט שבה ANTLR אמור ליצור מנתחים, מאזינים,
מבקרים וקבצי אסימונים.

-לב dir
ציין מיקום של דקדוקים, קבצי אסימונים.

כאשר מחפשים קבצי אסימונים ודקדוקים מיובאים, ANTLR בדרך כלל נראה ב-
ספרייה נוכחית. אפשרות זו מציינת באיזו ספרייה לחפש במקום זאת. זה
משמש רק לפתרון הפניות דקדוקיות עבור הצהרת הייבוא ​​וה-
אפשרות tokenVocab. יש לציין תמיד את הנתיב לדקדוק הראשי.

-אטנ צור דיאגרמות רשת מעבר מוגברת של כללים.

אפשרות זו מייצרת קובצי גרף DOT המייצגים את ה-ATN הפנימי (augmented
רשת מעבר) מבני נתונים ש-ANTLR משתמש בהם כדי לייצג דקדוקים. ה
קבצים יוצאים בתור Grammar.rule .dot. אם הדקדוק הוא דקדוק משולב, ה
כללי lexer נקראים Grammar Lexer.rule .dot.

-הַצפָּנָה שם קידוד
ציין קידוד קובץ דקדוק; למשל, euc-jp.

כברירת מחדל, ANTLR טוען קבצי דקדוק באמצעות קידוד UTF-8, וזה מאוד
קידוד קובץ תווים נפוץ שמתדרדר ל-ASCII עבור תווים שמתאימים
בייט אחד. אם קובץ הדקדוק הזה אינו ברירת המחדל של קידוד עבור המקום שלך, אתה
צריך אפשרות זו כדי ש-ANTLR יוכל לפרש כראוי קבצי דקדוק. זה לא
להשפיע על הקלט למנתחים שנוצרו, רק על הקידוד של הדקדוקים
עצמם.

-פורמט-הודעה פוּרמָט
ציין סגנון פלט עבור הודעות ב-antlr, gnu, vs2005.

ANTLR מייצר הודעות אזהרה והודעות שגיאה באמצעות תבניות מהספרייה
tool/resources/org/antlr/v4/tool/templates/messages/formats. כברירת מחדל, ANTLR
משתמש בקובץ antlr.stg (קבוצת StringTemplate). אתה יכול לשנות את זה ל'gnu' או
'vs2005' כדי ש-ANTLR ייצור הודעות המתאימות ל-Emacs או Visual Studio. ל
צור משלך בשם X, צור משאב
org/antlr/v4/tool/templates/messages/formats/X והצב אותו ב-CLASSPATH.

-הודעות ארוכות
הצג פרטי חריג כאשר הם זמינים עבור שגיאות ואזהרות.

-מַאֲזִין
צור מאזין עץ לנתח (ברירת מחדל).

-אין מאזין
אל תיצור מאזין לניתוח עץ.

-אורח
צור מבקר בעץ לנתח.

ANTLR יכול ליצור גם מאזינים לניתוח עצים וגם מבקרים; אפשרות זו ו
-מַאֲזִין אינם סותרים זה את זה.

-ללא מבקר
אל תיצור מבקר בעץ לנתח (ברירת מחדל).

-חֲבִילָה שם חבילה
ציין חבילה/מרחב שמות עבור הקוד שנוצר.

השתמש באפשרות זו כדי לציין חבילה או מרחב שמות עבור קבצים שנוצרו על ידי ANTLR.
לחלופין, אתה יכול להוסיף פעולת @header {...} אך זו קושרת את הדקדוק ל-a
שפה ספציפית. אם אתה משתמש באפשרות זו וב-@header, ודא שהכותרת
הפעולה אינה מכילה מפרט חבילה אחרת הקוד שנוצר יעשה זאת
יש שניים מהם.

-לִסְמוֹך
צור תלות בקבצים.

במקום ליצור מנתח ו/או לקסר, צור רשימה של תלות בקבצים,
אחד בכל שורה. הפלט מראה במה תלוי כל דקדוק ומה הוא מייצר.
זה שימושי לבניית כלים שצריכים לדעת תלות בדקדוק של ANTLR.

אם אתה משתמש -לב libdir עם -לִסְמוֹך ואפשרות דקדוק tokenVocab=A, ואז ה-
התלות כוללות גם את נתיב הספרייה.

-Xforce-atn השתמש בסימולטור ATN עבור כל התחזיות
-Xlog זרוק הרבה מידע רישום ל-antlr-timestamp.log

-ד =
הגדר או תעקוף אפשרות ברמת הדקדוק.

אפשרות זו שימושית ליצירת מנתחים בשפות שונות ללא
שינוי הדקדוק עצמו (עם --Dlanguage=CSharp לדוגמה).

-שגיאה
התייחסו לאזהרות כאל שגיאות.

כחלק ממבנה גדול, הודעות אזהרה של ANTLR עלולות להישאר מעיניהם. הפעל את זה
אפשרות להתייחס לאזהרות כשגיאות, מה שגורם לכלי ANTLR לדווח על כשל
חזרה למעטפת שורת הפקודה המעוררת.

-XdbgST
הפעל את StringTemplate Visualizer בקוד שנוצר.

עבור אלה שבונים יעד ליצירת קוד, אפשרות זו מעלה חלון המציג
הקוד שנוצר והתבניות המשמשות ליצירת הקוד הזה. זה מעורר את
חלון המפקח של StringTemplate.

-XdbgSTWait
המתן לסגירת STViz לפני שתמשיך.

-Xforce-atn
השתמש בסימולטור ATN עבור כל התחזיות.

ANTLR בדרך כלל בונה החלטות מסורתיות מסוג "התג אסימון" במידת האפשר
(אסימון אחד של מבט קדימה מספיק כדי להבחין בין כל החלופות ב-a
הַחְלָטָה). לכפות אפילו את ההחלטות הפשוטות הללו לתוך מנגנון ה-LL(*) האדפטיבי,
השתמש באפשרות זו.

-Xlog זרוק הרבה מידע רישום אל antlr-timestamp.log.

אפשרות זו יוצרת קובץ יומן המכיל הרבה הודעות מידע מ-ANTLR
כפי שהוא מעבד את הדקדוק שלך. אם תרצה לראות כיצד ANTLR מתרגם את שלך
כללים רקורסיביים שמאלה, הפעל את האפשרות הזו וחפש בקובץ היומן שנוצר.

השתמש ב-antlr4 באינטרנט באמצעות שירותי onworks.net