gccxml - מקוון בענן

תָכְנִית:

שֵׁם

gccxml - צור ייצוג XML של הצהרות C++.

תַקצִיר

gccxml [אפשרויות] -fxml=

תיאור

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

אפשרויות

האפשרויות הבאות זמינות להפעלת GCC-XML:

--זכויות יוצרים
הדפס את זכויות היוצרים של GCC-XML וצא.

--לנפות
הדפס מידע נוסף על ניפוי באגים. אפשרות זו גורמת ל-GCC-XML להדפיס את
שם ההפעלה וארגומנטים של שורת הפקודה המשמשים לביצוע ה-GCC C++ המתוקן
מנתח. זה שימושי כאשר מנסים לדמות מהדר לא נתמך.

-fxml=
ציין את קובץ הפלט של XML. אפשרות זו מועברת ישירות ל-GCC המתוקן
מנתח C++. זה מאפשר את dump XML ומציין את שם קובץ הפלט.

-fxml-start= [,...]
ציין רשימה של הצהרות התחלה. אפשרות זו מועברת ישירות ל-
מנתח GCC C++ מתוקן. יש לזה משמעות רק אם מצוין גם -fxml=. זֶה
מציין רשימה מופרדת בפסיקים של הצהרות מתחילות בשמות. GCC-XML יזרוק
רק תת-קבוצת ההצהרות ביחידת התרגום שניתן להגיע אליה
דרך רצף של הפניות מקור מאחת מההתחלה שצוינה
הצהרות.

--gccxml-מהדר
הגדר את GCCXML_COMPILER ל-"xxx".

--gccxml-cxxflags
הגדר את GCCXML_CXXFLAGS ל-"xxx".

--gccxml-קובץ הפעלה
הגדר את GCCXML_EXECUTABLE ל-"xxx".

--gccxml-cpp
הגדר את GCCXML_CPP ל-"xxx".

--gccxml-config
הגדר את GCCXML_CONFIG ל-"xxx".

--gccxml-root
הגדר את GCCXML_ROOT ל-"xxx".

--gccxml-gcc-options
קרא את אפשרויות GCC מהקובץ "xxx". אפשרות זו מציינת קובץ שממנו ניתן לקרוא
אפשרויות להעביר למנתח GCC C++ המתוקן. זה שימושי לציון א
רשימה ארוכה של ספריות כוללות. כל שורה בקובץ הופכת לאפשרות אחת. ריק
מתעלמים מהשורות והשורות המתחילות ב-'#'.

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

--עזרה-html
הדפס עזרה מלאה בפורמט HTML. אפשרות זו משמשת מחברי GCC-XML כדי לעזור
לייצר דפי אינטרנט.

--איש הדפס דף איש UNIX וצא. אפשרות זו משמשת מחברי GCC-XML ליצירת
דף האיש של UNIX.

--הדפס
הדפס הגדרות תצורה וצא. ל-GCC-XML אפשרויות תצורה רבות
לעזור לו לדמות מהדר אחר. שימוש באפשרות זו יגרום ל-GCC-XML
להגדיר את עצמו כאילו הוא הולך לנתח את המקור C++, אבל עצור ומדפיס
התצורה שנמצאה. זה שימושי לבדיקת התצורה.

-- תהליך מקדים
עבד מראש את הקלט והיציאה. GCC-XML מדמה את המעבד של אחר
מַהְדֵר. שימוש באפשרות זו יגרום ל-GCC-XML להגדיר את עצמו כאילו היה
הולך לנתח את המקור C++, אבל מפסיק לאחר עיבוד מקדים. זה שימושי עבור
בעיות איתור באגים הקשורות לסימולציה של המהדר האחר.

-E כינוי עבור --preprocess.

--גִרְסָה
הצג באנר של שם תוכנית/גרסה וצא.

דגלים אחרים, כגון -I ו-D, מועברים לקובץ ההפעלה של מנתח GCC C++ המתוקן.

הגדרות

GCC-XML נועד לדמות מנתח מהדר בזמן קריאת קוד המקור של C++. כמה
יש צורך בהגדרות תצורה כדי לקבוע כיצד לדמות מהדר מסוים של
בחירת המשתמש. ניתן להשתמש בהגדרות הבאות כדי להגדיר את GCC-XML:

GCCXML_COMPILER
המהדר C++ שיש לדמות. GCC-XML ינסה לקבוע באופן אוטומטי
כיצד לדמות את המהדר שצוין בהגדרה זו. המהדר מצוין
לפי שם ההפעלה שלו (כגון "g++"). עבור Visual Studio, המהדר הוא
המצוין על ידי "msvc6", "msvc7", "msvc71" או "msvc8" (אם ניתן "cl", GCC-XML
מנסה לנחש באיזה VS להשתמש).

GCCXML_CXXFLAGS
הדגלים עבור המהדר C++ לסימולציה. ההתנהגות של רוב המהדרים יכולה
להיות מותאם על ידי ציון דגלים בשורת הפקודה. כאשר GCC-XML מנסה
לקבוע באופן אוטומטי כיצד לדמות מהדר, הדגלים הללו נלקחים בחשבון
הִתחַשְׁבוּת.

GCCXML_CONFIG
קובץ התצורה להגדרות נפוצות. כאשר הגדרות שאינן ברירת מחדל הן לעתים קרובות
בשימוש, נוח לכתוב קובץ בודד המכיל אותם. כאשר קובץ כזה הוא
שצוין, הוא ייקרא כדי להגדיר הגדרות שעדיין אינן ידועות. כל אחד
שורת הקובץ מורכבת מהקצאה אחת בצורת KEY="VALUE" (לדוגמה,
GCCXML_COMPILER="g++").

GCCXML_EXECUTABLE
ציין את קובץ ההפעלה של מנתח GCC C++ המתוקן. תוכנית GCC-XML כפי שנראית על ידי
משתמש הוא למעשה קצה קצה שקובע את הדגלים הדרושים כדי להגדיר את
תיקון GCC C++ מנתח כדי לדמות מהדר אחר. הגדרה זו מציינת את
קובץ הפעלה אמיתי להפעלה לאחר שהדגלים נקבעו. משתמשים צריכים לעתים רחוקות
צריך לשנות את הערך הזה מברירת המחדל שלו.

GCCXML_CPP
ציין את קובץ ההפעלה המקדים של GCC C. תוכנית GCC-XML כפי שנראתה על ידי המשתמש
הוא למעשה קצה קצה שקובע את הדגלים הדרושים כדי להגדיר את התיקון
מנתח GCC C++ כדי לדמות מהדר אחר. הגדרה זו מציינת את
מעבד קדם שיפעל עם הדגלים שנקבעו לניפוי באגים
מטרות. משתמשים צריכים רק לעתים רחוקות לשנות ערך זה מברירת המחדל שלו.

GCCXML_ROOT
ספריית ספריית התמיכה של GCC-XML. מכיוון ש-GCC-XML הוא רק מנתח C++ אחד, זה
לא יכול לשכפל בדיוק את הפונקציונליות של כל מהדר שהוא מנסה לדמות.
כמה מהדרים מספקים כותרות סטנדרטיות עם קוד ש-GCC-XML אינו יכול ישירות
ידית. כדי לעקוף מגבלה זו, ניתנת ספריית תמיכה לכל אחד מהם
מַהְדֵר. זה מורכב מקבוצה של קובצי כותרות המשמשים במקום ה-
כותרות המערכת של המהדר. קבצים אלה מכילים שינויים קלים ולאחר מכן כוללים את
כותרת אמיתית מתאימה. השורש של עץ הספריות המכיל תמיכה אלה
כותרות הספרייה מצוינות בהגדרה זו. משתמשים צריכים רק לעתים רחוקות לשנות
ערך זה מברירת המחדל שלו.

GCCXML_FLAGS
דגלים המשמשים כדי לדמות את המהדר האחר. כאשר GCC-XML מפעיל את ה-GCC C++ המתוקן
מנתח, הדגלים הללו מועברים לתוכנית כדי לומר לה כיצד לדמות א
מהדר מסוים. הגדרה זו מזוהה בדרך כלל אוטומטית מהאחר
הגדרות, אבל זה יכול להיות מוגדר ישירות על ידי משתמשים מתקדמים. רוב המשתמשים צריכים
אל תנסה לשנות ערך זה מהתצורה האוטומטית.

GCCXML_USER_FLAGS
דגלי משתמש נוספים להדמיית מהדר. כאשר GCC-XML מפעיל את ה-GCC המתוקן
מנתח C++, הדגלים הללו מועברים בנוסף לאלו שצוינו על ידי GCCXML_FLAGS.
זה מאפשר למשתמשים מתקדמים להתאים את סימולציית המהדר תוך שימוש ב-
תצורה אוטומטית של GCCXML_FLAGS. משתמשים צריכים רק לעתים רחוקות לשנות זאת
ערך מברירת המחדל שלו.

ישנם מספר אמצעים שבהם הגדרות אלו נקבעות. הם רשומים כאן ב
סדר עדיפות (הגבוה ביותר ראשון):

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

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

תְצוּרָה קבצים
מתבצע חיפוש של GCCXML_CONFIG. אם GCCXML_CONFIG עדיין לא הוגדר, an
נעשה ניסיון למצוא קובץ תצורה באופן אוטומטי. ראשית, אם הקובץ
$HOME/.gccxml/config קיים, הוא ישמש. שנית, אם GCC-XML מבוצע
מספריית ה-build שלה, ישמש קובץ תצורה מאותה ספרייה. סוף כל סוף,
אם קובץ תצורה נמצא בספריית התמיכה של ההתקנה, הוא ימצא אותו
לשמש. ברגע שנמצא, כל הגדרות לא ידועות נקראות מקובץ התצורה.

מנחש
ניחושים נעשים על סמך הגדרות אחרות. לאחר הגדרת GCCXML_COMPILER, זהו
משמש לאיתור אוטומטי של ההגדרה עבור GCCXML_FLAGS. אם זה לא מוגדר, ה
משתנה הסביבה "CXX" נבדק כמוצא אחרון כדי למצוא את הגדרת המהדר
וקבע את GCCXML_FLAGS.

רוב המשתמשים לא צריכים להתאים את ברירת המחדל עבור הגדרות אלה. יש ברירת מחדל
קובץ GCCXML_CONFIG מסופק בספריית התמיכה לאחר ההתקנה. זה
מגדיר את GCC-XML כדי לדמות את המהדר ששימש לבנייתו.

מהדרים

GCC-XML יכול לדמות כל אחד מהמהדרים הבאים:

GCC גרסאות 4.2, 4.1, 4.0, 3.4, 3.3, 3.2, 2.95.x

חזותי C + +
גרסאות 8, 7.1, 7.0 ו-6 (sp5)

בורלנד, אינטל, SGI
נתמך בעבר אך לא נבדק עוד

ההגדרות הבאות של Preprocessor C הנוספות מסופקות:

-D__GCCXML__=MMmmpp
MM, mm ו-pp הן הגירסאות העיקריות, המשניות והתיקון של GCC-XML. זֶה
סמל מעבד קדם מזהה את GCC-XML לקוד המקור בזמן שהוא מעובד מראש.
ניתן להשתמש בו כדי להפעיל מידע ספציפי ל-GCC-XML.

-D__GCCXML_GNUC__=M
מוגדר לגרסה הראשית של מנתח GCC פנימית.

-D__GCCXML_GNUC_MINOR__=מ
מוגדר לגרסה משנית של מנתח GCC פנימית.

-D__GCCXML_GNUC_PATCHLEVEL__=p
מוגדר לרמת תיקון GCC פנימית.

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

METAINFO

GCC-XML הוסיפה תכונה חדשה לקבוצה החוקית של תכונות C/C++. התכונה היא
משמש לצירוף מטא מידע לקוד המקור C/C++, שיופיע לאחר מכן ב-XML
תְפוּקָה. התחביר להכרזה על תכונה הוא כדלקמן:

__attribute((gccxml( , , ...)))
פה הוא מחרוזת מצוטטת. חייב להיות טיעון אחד לפחות
תכונה 'gccxml', אך אין גבול עליון למספר הכולל של הארגומנטים.
כל ארגומנט מאומת כמחרוזת - אם נמצא ארגומנט שאינו מחרוזת, ה-
מתעלמים מהתכונה.

פלט ה-XML עבור רכיב הקוד שמתויג עם התכונה יכיל אז
הבא:

מאפיינים=" ... gccxml( , , ...) ...
תכונת ה-XML 'attributes' מכילה את כל התכונות שהוחלו על רכיב הקוד.
כל ארגומנט של התכונה מודפס ללא צירוף מרכאות, כך שאם an
הארגומנט מכיל את התו ',', נראה שהארגומנט מרובה
ארגומנטים.

ניתן להחיל את התכונה 'gccxml' על כל הצהרה, כולל מבנים, מחלקות,
שדות, פרמטרים, שיטות, פונקציות, משתנים ו-typedefs. היוצא מן הכלל היחיד הוא
שהטיפול של GCC ברכיב השפה '__attribute' פגום כרגע
ספירות ובונים עם גוף משולב. ניתן להשתמש בתכונה 'gccxml'
כל מספר פעמים בהצהרה נתונה.

כדוגמה לאופן שבו ניתן להשתמש בתכונה זו כדי לצרף מטא מידע ל-C++
הצהרות, שקול את המאקרו הבא:

#define _הַחוּצָה_ __attribute((gccxml("out")))
כאן '_out_' הוגדר כמאפיין gccxml שבו הארגומנט הראשון
האם המחרוזת "בחוץ". מומלץ להשתמש בטיעון הראשון כייחודי
שם המחרוזת עבור סוג המידע המטא מתחיל להחיל.

כעת ניתן לכתוב הצהרת שיטה באופן הבא:

לבטל את getInteger(_out_ int& אני);
זה יגרום לפלט ה-XML להכיל מטא מידע עבור '_out_'
תכונה, בצורה "gccxml(out)".

שימוש בתכונה 'gccxml' מאפשר לכלול מטא מידע ישירות בתוך C++
קוד מקור, ללא צורך במנתח מותאם אישית כדי לחלץ את המטא מידע. ה
התכונה 'gccxml' מסופקת מטעמי נוחות בלבד - אין ערובה לעתיד הזה
גרסאות של GCC יקבלו את רכיב השפה '__attribute' באופן נטול באגים.

זכויות יוצרים

GCC-XML - פלט XML עבור GCC

זכויות יוצרים 2002-2012 Kitware, Inc., Insight Consortium

הפצה מחדש ושימוש בצורות מקור ובינאריות, עם או בלי שינוי, הם
מותר בתנאי שמתקיימים התנאים הבאים:

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

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

* לא השמות של Kitware, Inc., קונסורציום Insight Software, ולא השמות
מהתורמים שלהם עשויים לשמש כדי לאמץ או לקדם מוצרים שנגזרו מכך
תוכנה ללא אישור ספציפי מראש ובכתב.

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

-------------------------------------------------- ----------

gccxml_cc1plus - מנתח GCC תוקן עבור מטילות XML של יחידות תרגום

זכויות יוצרים 2002-2012 Kitware, Inc., Insight Consortium

תוכנית זו היא תוכנה חופשית; אתה יכול להפיץ אותו מחדש ו/או לשנות אותו תחת התנאים של
הרישיון הציבורי הכללי של GNU כפי שפורסם על ידי קרן התוכנה החופשית; אוֹ
גרסה 2 של הרישיון, או (לפי בחירתך) כל גרסה מאוחרת יותר.

תוכנית זו מופצת בתקווה שהיא תהיה שימושית, אך ללא כל אחריות;
אפילו ללא האחריות המשתמעת של סחירות או התאמה למטרה מסוימת.
עיין ברישיון הציבור הכללי של GNU לפרטים נוספים.

היית צריך לקבל עותק של הרישיון הציבורי הכללי של GNU יחד עם תוכנית זו;
אם לא, כתוב ל-
קרן תוכנה חופשית, Inc.
רחוב פרנקלין 51, קומה חמישית
בוסטון, MA 02110-1301 ארה"ב

דואר רשימה

לקבלת עזרה ודיון על השימוש ב-gccxml, רשימת דיוור מסופקת בכתובת
[מוגן בדוא"ל]. אנא קרא תחילה את התיעוד המלא בכתובת http://www.gccxml.org
לפני פרסום שאלות לרשימה.

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