cproto - מקוון בענן

תָכְנִית:

שֵׁם

cproto - יצירת אבות טיפוס של פונקציות C והמרת הגדרות פונקציות

תַקצִיר

cproto [ אוֹפְּצִיָה ... ] [ פילה ... ]

תיאור

Cproto יוצר אבות טיפוס של פונקציות עבור פונקציות המוגדרות בקובצי המקור C שצוינו
לפלט הסטנדרטי. הגדרות הפונקציה עשויות להיות בסגנון הישן או בסגנון ANSI C.
אופציונלי, cproto גם פלט הצהרות עבור משתנים המוגדרים בקבצים. אם לא
פילה ניתן טיעון, cproto קורא את הקלט שלו מהקלט הסטנדרטי.

על ידי מתן אפשרות שורת פקודה, cproto ימיר גם הגדרות פונקציות ב-
קבצים שצוינו מהסגנון הישן לסגנון ANSI C. קבצי המקור המקוריים יחד
עם קבצים שצוינו על ידי
#include "קובץ"
הנחיות המופיעות בקוד המקור יוחלפו בקוד שהומר. אם
לא ניתנים שמות קבצים בשורת הפקודה, ואז התוכנה קוראת את קוד המקור ממנו
הקלט הסטנדרטי ומוציא את המקור המומר לפלט הסטנדרטי.

אם מופיעות הערות כלשהן בהצהרות הפרמטרים עבור הגדרת פונקציה, כגון ב
הדוגמה,
main (argc, argv)
int argc; /* מספר ארגומנטים */
char *argv[]; /* ארגומנטים */
{
}
אז להגדרת הפונקציה המומרת תהיה הצורה
int
ראשי (
int argc, /* מספר ארגומנטים */
char *argv[] /* ארגומנטים */
)
{
}
אחרת, הגדרת הפונקציה המומרת תיראה כך
int
main (int argc, char *argv[])
{
}

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

Cproto יכול ליצור מקור באופן אופציונלי בפורמט של ספריית מוך. זה שימושי ב
סביבות שבהן מוך כלי השירות משמש כתוספת לבדיקת אב טיפוס שלך
תכנית.

אפשרויות

-e פלט את מילת המפתח חיצוני מול כל אב טיפוס או הצהרה שנוצרו
יש היקף גלובלי.

-f n הגדר את הסגנון של אבות טיפוס פונקציות שנוצרו איפה n הוא מספר מ-0 עד 3.
לדוגמה, שקול את הגדרת הפונקציה
main (argc, argv)
int argc;
char * argv [];
{
}
אם הערך הוא 0, אז לא נוצרים אבות טיפוס. כאשר מוגדר ל-1, הפלט הוא:
int main(/*int argc, char *argv[]*/);
עבור ערך 2, לפלט יש את הצורה:
int main(int /*argc*/, char */*argv*/[]);
ערך ברירת המחדל הוא 3. הוא מייצר את אב הטיפוס המלא של הפונקציה:
int main(int argc, char *argv[]);

-l צור טקסט עבור ספריית מוך (עובר את "-f" אפשרות). הפלט כולל
התגובה
/* LINTLIBRARY */
הערות מיוחדות LINT_EXTERN ו-LINT_PREPRO (א-לה "VARARGS") מופעלות בהתאמה
האפשרות "-x" והעתק טקסט הערה לפלט (לעיבוד מקדים ב מוך).
השתמש בהערה
/* LINT_EXTERN2 */
לכלול חיצוניים המוגדרים ברמה הראשונה של קבצי include. השתמש בהערה
/* LINT_SHADOWED */
לגרום cproto לשים הנחיות "#undef" לפני כל הצהרת ספריית מוך
(כלומר, כדי למנוע התנגשויות עם פקודות מאקרו שבמקרה צריך להיות שם כמו
הפונקציות, ובכך לגרום לשגיאות תחביר).

שימו לב שההערות המיוחדות הללו אינן נתמכות תחת VAX/VMS, מכיוון שאין
שווה ערך לאפשרות "-C" של cpp עם VAX-C.

-c הערות הפרמטרים באבות הטיפוס שנוצרו על ידי האפשרויות -f1 ו-f2 הן
הושמט כברירת מחדל. השתמש באפשרות זו כדי להפעיל את הפלט של הערות אלה.

-m שים מאקרו סביב רשימת הפרמטרים של כל אב טיפוס שנוצר. לדוגמה:
int main P_((int argc, char *argv[]));

-M שם
הגדר את שם המאקרו המשמש להקיף רשימות פרמטרים של אב טיפוס כאשר אפשרות -m
נבחר. ברירת המחדל היא "P_".

-d השמט את ההגדרה של מאקרו אב הטיפוס המשמש את האפשרות -m.

-o פילה
ציין את שם קובץ הפלט (ברירת מחדל: פלט סטנדרטי).

-O פילה
ציין את שם קובץ השגיאה (ברירת מחדל: שגיאה רגילה).

-p השבת קידום של פרמטרים פורמליים בהגדרות פונקציות בסגנון ישן. על ידי
ברירת מחדל, פרמטרים של סוג char or קצר בסגנון ישן הגדרות פונקציות הן
מקודם לסוג int באב הטיפוס של הפונקציה או בפונקציית ANSI C המרה
הַגדָרָה. פרמטרים של סוג לצוף לקבל קידום ל לְהַכפִּיל גם כן.

-q אל תוציא הודעות שגיאה כלשהן כאשר התוכנית אינה יכולה לקרוא את הקובץ שצוין ב
an #include הוראה.

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

-S פלט הצהרות סטטיות בלבד.

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

-T העתק הגדרות סוג מכל קובץ. (הגדרות בקבצים הכלולים מועתקות,
בניגוד לאפשרות "-l")).

-v כמו כן פלט הצהרות למשתנים המוגדרים במקור.

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

-X רָמָה
אפשרות זו מגבילה את רמת ה-include-fil שממנה שולפים הצהרות על ידי
בחינת פלט הפרה-מעבד.

-a המרת הגדרות פונקציות מהסגנון הישן לסגנון ANSI C.

-t המרת הגדרות פונקציות מסגנון ANSI C לסגנון המסורתי.

-b כתוב מחדש את ראשי הגדרת הפונקציות כדי לכלול גם סגנון ישן וגם סגנון חדש
הצהרות מופרדות על ידי הוראת חיבור מותנה. לדוגמה, ה
התוכנית יכולה ליצור את הגדרת הפונקציה הזו:
#ifdef ANSI_FUNC

int
main (int argc, char *argv[])
#else

int
main (argc, argv)
int argc;
char *argv[]
#endif
{
}

-B הוראה
הגדר את הוראת ההידור המותנית לפלט בתחילת הפונקציה
הגדרות שנוצרו על ידי האפשרות -b. ברירת המחדל היא
#ifdef ANSI_FUNC

-P תבנית
-F תבנית
-C תבנית
הגדר את פורמט הפלט עבור אבות טיפוס שנוצרו, הגדרות פונקציה ופונקציה
הגדרות עם הערות פרמטרים בהתאמה. הפורמט מצוין על ידי א
תבנית בטופס
"int f (א, ב)"
אבל אתה יכול להחליף כל רווח במחרוזת הזו בכל מספר של רווחים
דמויות. למשל, האפשרות
-F"int f(\n\ta,\n\tb\n\t)"
יפיק
int main(
int,
char *argv[]
)

-D שם[=ערך]
אפשרות זו מועברת למעבד המקדים ומשמשת להגדרת סמלים עבור
שימוש עם תנאים כגון #ifdef.

-U שם
אפשרות זו מועברת למעבד המקדים ומשמשת להסרת כל
הגדרות של סמל זה.

-I בספרייה
אפשרות זו מועברת למעבד המקדים ומשמשת לציון א
ספרייה לחיפוש קבצים שאליהם יש הפניה #לִכלוֹל.

-E cpp העבר את קבצי הקלט דרך פקודת הקדם-מעבד שצוינה בעת ההפקה
אבות טיפוס. כברירת מחדל, התוכנית משתמשת ב-/lib/cpp.

-E 0 אל תפעיל את מעבד הקדם C.

-V מידע על גרסת הדפסה.

הסביבה

משתנה הסביבה CPROTO נסרק עבור רשימה של אפשרויות באותו פורמט כמו ה-
אפשרויות שורת הפקודה. האפשרויות הניתנות בשורת הפקודה עוקפות כל תואם
אפשרות סביבה.

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