c++decl - מקוון בענן

תָכְנִית:

שֵׁם

cdecl, c++decl - צור הצהרות מסוג C ו-C++

תַקצִיר

cdecl [-א | -+ | -p | -r] [-ciqdDV]
[[ קבצים ...] | להסביר ... | לְהַכרִיז ... | להטיל ... | סט ... | לעזור | ? ]
c++decl [-א | -+ | -p | -r] [-ciqdDV]
[[ קבצים ...] | להסביר ... | לְהַכרִיז ... | להטיל ... | סט ... | לעזור | ? ]
להסביר ...
לְהַכרִיז ...
להטיל ...

תיאור

Cdecl (ו c++decl) היא תוכנית לקידוד ופענוח הצהרות מסוג C (או C++).
שפת C מבוססת על (הטיוטה המוצעת) X3J11 ANSI Standard; לחלופין, ה-C
השפה עשויה להתבסס על ההגדרה שלפני ANSI שהוגדרה על ידי Kernighan & Ritchie's אל האני C
תכנות שפה ספר, או שפת C שהוגדרה על ידי המהדר Ritchie PDP-11 C.
שפת C++ מבוססת על שפת Bjarne Stroustrup אל האני C + + תכנות שפה, בתוספת
תוספות גרסה 2.0 לשפה.

אפשרויות

-א השתמש בניב ANSI C של שפת C.

-p השתמש בניב הקדם-ANSI שהוגדר על ידי הספר של Kernighan & Ritchie.

-r השתמש בניב שהוגדר על ידי המהדר Ritchie PDP-11 C.

-+ השתמש בשפת C++, במקום C.

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

-ש השקט את ההנחיה. מכבה את ההנחיה במצב אינטראקטיבי.

-c צור קומפילציה של קוד C או C++ כפלט. Cdecl יוסיף נקודה-פסיק לסוף
של הצהרה וזוג פלטה מתולתלת לסוף הגדרת פונקציה.

-ד הפעל מידע על ניפוי באגים (אם הידור).

-D הפעל את מידע איתור באגים של YACC (אם הידור).

-V הצגת מידע גרסה ויציאה.

מזמין

Cdecl ניתן להפעיל תחת מספר שמות שונים (על ידי שינוי שם קובץ ההפעלה,
או יצירת קישור סימלי או קישור קשיח אליו). אם הוא מופעל כ cdecl אז ANSI C הוא
שפת ברירת מחדל. אם הוא מופעל כ c++decl אז C++ הוא ברירת המחדל. אם זה מופעל
כמו גם להסביר, להטיל, או לְהַכרִיז אז זה יפרש את שאר שורת הפקודה
אפשרויות כפרמטרים לפקודה זו, בצע את הפקודה וצא. זה גם יעשה
זאת אם הארגומנט הראשון שאינו מתג בשורת הפקודה הוא אחת משלוש הפקודות הללו.
קלט עשוי להגיע גם מקובץ.

Cdecl קורא את הקבצים בעלי השם עבור הצהרות בשפה המתוארת להלן. א
הטרנספורמציה מתבצעת משפה זו ל-C (C++) או פסאודו-אנגלית. התוצאות של
השינוי הזה נכתב על פלט סטנדרטי. אם אין שם קבצים, או שם קובץ
של ``-'' נתקל, קלט סטנדרטי ייקרא. אם קלט סטנדרטי מגיע מא
מסוף, (או ה -i בשימוש), תיכתב הנחיה למסוף לפני כל אחת מהן
קַו. ניתן לכבות את ההנחיה על ידי -q אפשרות (או ה סט ללא הנחיה פקודה). אם
cdecl מופעל כ- להסביר, לְהַכרִיז or להטיל, או הארגומנט הראשון הוא אחת הפקודות
הנדון להלן, רשימת הטיעונים תתפרש בהתאם לדקדוק המוצג
למטה במקום בתור שמות קבצים.

כאשר הוא מופעל באופן אינטראקטיבי, cdecl משתמש בספריית ה-readline של GNU כדי לספק מילת מפתח
היסטוריית השלמה ושורת פקודה, מאוד דומה לחבוט(1) (qv). לחיצה על TAB תעשה
השלם את מילת המפתח החלקית לפני הסמן, אלא אם כן יש יותר מאחת אפשרית
השלמה, ובמקרה זה TAB שני יציג את רשימת ההשלמות האפשריות ו
הצג מחדש את שורת הפקודה. ניתן להשתמש במקשי החצים שמאלה וימינה וב-backspace
עריכה בצורה טבעית, ומקשי החצים למעלה ולמטה מאחזרים שורות פקודה קודמות
מההיסטוריה. רוב המקשים המוכרים האחרים, כגון Ctrl-U למחיקת כל הטקסט מה-
סמן חזרה לתחילת השורה, עבד כמצופה. יש אי בהירות ביניהם
מה היא int ו אל תוך מילות מפתח, אבל cdecl ינחש לאיזה מהם התכוונת, והוא תמיד מנחש
נכונה.

אתה יכול להשתמש cdecl כפי שאתה יוצר תוכנית C עם עורך כמו vi(1) או Emacs(1). אתה
פשוט הקלד את הגרסה הפסאודו-אנגלית של ההצהרה והחל cdecl כמסנן
אל הקו. (ב vi(1), הקלד ``!!cdecl''.)

אם לִיצוֹר התוכנית אוֹפְּצִיָה -c נעשה שימוש, הפלט יכלול נקודה-פסיק לאחר
הצהרות משתנות וזוגות סד מתולתל לאחר הצהרות פונקציות.

אל האני -V option תדפיס את מספרי הגרסה של הקבצים המשמשים ליצירת התהליך.
אם המקור הידור עם מידע ניפוי באגים מופעל, ה- -d האפשרות תאפשר
זה להיות פלט. אם המקור הידור עם מידע איתור באגים של YACC מופעל, ה
-D האפשרות תאפשר לו להיות פלט.

פקודה שָׂפָה

יש שש הצהרות בשפה. ה לְהַכרִיז המשפט מרכיב סוג C
הצהרה מתיאור מילולי. ה להטיל הצהרה מרכיבה יצוק מסוג C כ
עשוי להופיע בביטוי. ה להסביר המשפט מפענח הצהרת מסוג C או
שחקנים, המייצרים תיאור מילולי. ה לעזור (אוֹ ?) הצהרה מספקת עזרה
הוֹדָעָה. ה להפסיק (אוֹ יציאה) המשפט (או סוף הקובץ) יוצא מהתוכנית. ה סט
הצהרה מאפשרת להגדיר את אפשרויות שורת הפקודה באופן אינטראקטיבי. כל אמירה היא
מופרדים על ידי נקודה-פסיק או קו חדש.

סינונימים

כמה מילים נרדפות מותרות במהלך הצהרה:

תו הוא מילה נרדפת ל-char
קבוע הוא מילה נרדפת לקונסט
ספירה היא מילה נרדפת ל-enum
func היא מילה נרדפת לפונקציה
מספר שלם הוא מילה נרדפת ל-int
ptr היא מילה נרדפת למצביע
ref היא מילה נרדפת להפניה
ret היא מילה נרדפת לחזרה
מבנה הוא מילה נרדפת למבנה
וקטור הוא מילה נרדפת למערך

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

דקדוק

הדקדוק הבא מתאר את השפה. בדקדוק, מילים ב"<>" אינן-
טרמינלים, מילים חשופות באותיות קטנות הן מסופים שעומדים בפני עצמם. אותיות גדולות חשופות
מילים הן אסימונים מילוניים אחרים: שום דבר לא אומר המחרוזת הריקה; NAME פירושו מזהה C;
NUMBER פירושו מחרוזת של ספרות עשרוניות; ו-NL פירושו קו חדש או נקודה-פסיק
תווים.

::= כלום
| NL
::= כלום
| להכריז על NAME בתור
| לְהַכרִיז
| העבר את NAME לתוכו
| ללהק
| להסביר
| להסביר
| להסביר ( ) אופציונלי-NAME
| מַעֲרֶכֶת
| עזרה | ?
| לְהַפְסִיק
| יְצִיאָה
::= מערך של
| מערך NUMBER מתוך
| פונקציה חוזרת
| פונקציה ( ) חוזר
| מצביע ל
| מצביע לחבר בכיתה NAME
| התייחסות ל
|
::=
| *
| שם :: *
| &
::= ( )
| ( )
| [ ]
| [ מספר ]
| ( )
| שֵׁם
::= כלום
| ( )
| ( ) ( )
| ( ) ( )
| ( )
| שם :: *
| *
| &
| [ ]
| [ מספר ]
::= |
|
| מבנה NAME | איגוד שם | enum NAME | כיתה NAME
::= ,
|
|
::= ,
| שום דבר
|
|
| כפי ש
::= int | char | כפול | לצוף | בָּטֵל
::= |
::= קצר | ארוך | לא חתום | חתום |
::= | שום דבר
::= קונסט | נדיף | נואליות
::= אוטומטי | חיצוני | להירשם | סטָטִי
::= שום דבר |
::= שום דבר |
| ליצור | nocreate
| הנחיה | ללא הנחיה
| ritchie | preansi | אנסי | cplusplus
| ניפוי באגים | nodebug | yydebug | noyydebug

SET אפשרויות

אל האני סט הפקודה לוקחת מספר אפשרויות. אתה יכול להקליד סט or סט אפשרויות לראות את ה
אפשרויות שנבחרו כעת וסיכום של האפשרויות הזמינות. הראשון
ארבעה תואמים את -a, -p, -r, ו -+ אפשרויות שורת הפקודה, בהתאמה.

ansi השתמש בניב ANSI C של שפת C.

preansi
השתמש בניב טרום-ANSI שהוגדר על ידי הספר של Kernighan & Ritchie.

ריצ'י
השתמש בניב שהוגדר על ידי המהדר Ritchie PDP-11 C.

cplusplus
השתמש בשפת C++, במקום C.

[לא] הנחיה
הפעל או כבה את ההנחיה במצב אינטראקטיבי.

[לא] ליצור
הפעל או כבה את הצמדת נקודה-פסיק או פלטה מתולתלת להצהרות
פלט על ידי cdecl. זה מתאים ל -c אפשרות שורת הפקודה.

[אין] ניפוי באגים
הפעל או כבה מידע על ניפוי באגים.

[no]yydebug
הפעל או כבה את מידע ניפוי באגים של YACC.

הערה: מידע איתור באגים ומידע איתור באגים YACC זמינים רק אם יש להם
חובר לתוך cdecl. שתי האפשרויות האחרונות מתאימות ל- -d ו -D שורת הפקודה
אפשרויות, בהתאמה. מידע על ניפוי באגים משמש בדרך כלל בפיתוח תוכניות, ו
בדרך כלל אינו מורכב לקובצי הפעלה מבוזרים.

דוגמאות

להכריז על מערך מצביעים לפונקציות דומות malloc(3), תעשה

להכריז על fptab כמערך של מצביע לפונקציה ומחזיר מצביע ל-char

התוצאה של פקודה זו היא

char *(*fptab[])()

כאשר אתה רואה את ההצהרה הזו בקוד של מישהו אחר, אתה יכול להבין את זה על ידי
עושה

הסבר char *(*fptab[])()

ההצהרה הראויה עבור אוֹת(2), תוך התעלמות מאבות טיפוס של פונקציות, מתואר בקלות ב
cdeclהשפה של:

להכריז על אות כפונקציה המחזירה מצביע לפונקציה המחזירה ריק

שמייצר

void (*אות())()

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

הכריז על אות כפונקציה (arg1,arg2) מחזיר מצביע לפונקציה המחזירה ריק

מספק את הפתרון הבא (כאשר פועל עם -c אוֹפְּצִיָה):

void (*signal(arg1,arg2))() { }

אם נרצה להוסיף לפונקציה אבות טיפוס, אב טיפוס של פונקציה לפונקציה כזו
as _יְצִיאָה(2) יוכרז עם:

להכריז על _exit כפונקציה (retvalue כ-int) המחזירה void

מתן

void _exit(int retvalue) { }

כדוגמה מורכבת יותר באמצעות אבות טיפוס של פונקציות, אוֹת(2) ניתן להגדיר באופן מלא כ:

להכריז על אות כפונקציה(x כ-int, y כמצביע לפונקציה(int) המחזירה ריק)
מחזיר מצביע לפונקציה(int) מחזיר ריק

נותן (עם -c)

void (*signal(int x, void (*y)(int )))(int ) { }

Cdecl יכול לעזור להבין היכן להכניס את המשתנים "const" ו"נדיפים".
הצהרות, כך

להכריז על foo כמצביע ל-const int

נותן

const int *foo

בזמן

להכריז על foo כ-const pointer to int

נותן

int * const foo

C++decl יכול לעזור בהצהרת הפניות, כך

להכריז על x כהתייחסות למצביע לתו

נותן

char *&x

C++decl יכול לעזור עם מצביעים לחבר בשיעורים, ובכך להכריז על מצביע ל- an
איבר שלם של מחלקה X עם

להכריז על foo כמצביע לחבר בכיתה X int

נותן

int X::*foo

ו

להכריז על foo כמצביע לאיבר בפונקציית מחלקה X (arg1, arg2) המחזיר מצביע
לכיתה י'

נותן

class Y *(X::*foo)(arg1, arg2)

דיאגנוסטיקה

ההצהרות מכריזות, מוצקות ומסבירות מנסים להצביע על מבנים שלא
נתמך ב-C. במקרים מסוימים, ניחוש למה באמת נועד. באלה
במקרים, תוצאת C היא הצהרת צעצוע שהסמנטיקה שלה תעבוד רק ב-Algol-68. ה
רשימה של מבני C שאינם נתמכים תלויה באיזו גרסה של שפת C נמצאת
בשימוש (ראה אפשרויות ANSI, pre-ANSI ו-Ritche). קבוצת מבני C++ הנתמכים
הוא ערכת-על של ערכת ה-ANSI, למעט ה- נואליות מילת מפתח.

ביבליוגרפיה

ANSI Standard X3.159-1989 (ANSI C)

ISO/IEC 9899:1990 (תקן ISO)

שאלות נפוצות על comp.lang.c
http://www.eskimo.com/~scs/C-faq.top.html

סעיף 8.4 של מדריך העזר C בתוך אל האני C תכנות שפה מאת B. Kernighan &
ד. ריצ'י.

סעיף 8 במדריך העזר של C++ בתוך אל האני C + + תכנות שפה מאת ב.
שטרוסטרופ.

מערות

התחביר הפסאודו-אנגלי הוא מילולי מדי.

יש שפע של בדיקות סמנטיות שלא נעשות.

Cdecl נכתב לפני השלמת תקן ANSI C, ולא נעשה כל ניסיון
כדי לעדכן אותו. עם זאת, זה קרוב מאוד לסטנדרט, עם המובן מאליו
למעט נואליות.

Cdeclההיקף של קטן בכוונה. זה לא עוזר לך להבין אתחולים. זה
מצפה ששיעורי אחסון יהיו בתחילת הצהרה, ואחריהם ה-
const, volatile ו-noalias modifiers, ואחריהם סוג המשתנה. Cdecl
לא יודע כלום על רשימות ארגומנטים באורך משתנה. (זה כולל את ה-``, ...''
תחביר.)

Cdecl חושב שכל ההצהרות שאתה משמיע ישמשו כהגדרות חיצוניות.
חלק מהקשרי הכרזה ב-C מאפשרים יותר גמישות מזו. דוגמה לכך היא:

להכריז על argv כמערך של מערך של char

איפה cdecl מגיב עם

אזהרה: לא נתמך ב-C -- 'מערך פנימי בגודל לא מוגדר'
(אולי אתה מתכוון ל"מערך של מצביע")
char argv[][]

תמיכה טנטטיבית עבור נואליות מילת המפתח הוכנסה מכיוון שהיא הייתה בטיוטת ANSI
מפרטים.

מחברים

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

תמיכה ב-readline של GNU ויציאת לינוקס מאת דיוויד ר. קונרד,[מוגן בדוא"ל]>

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