clang-modernize-3.5 - מקוון בענן

תָכְנִית:

שֵׁם

clang-modernize - דף מדריך ל-clang-modernize 3.5

תיאור

שימוש: צלצול מודרניזציה [אפשרויות] [ ...]

אפשרויות:

אפשרויות עיצוב:

-פוּרמָט - אפשר עיצוב של קוד שהשתנה על ידי החלת החלפות.
השתמש בסגנון כדי לבחור סגנון עיצוב.

-סגנון=- סגנון קידוד, תומך כרגע:
LLVM, Google, Chromium, Mozilla, WebKit.

השתמש בסגנון=פילה לטעינת תצורת סגנון
קובץ .clang-format הממוקם באחת מספריות האב של קובץ המקור (או
הספרייה הנוכחית עבור stdin). להשתמש -סגנון="{key: value, ...}" להגדרה ספציפית
פרמטרים, למשל:

-סגנון="{BasedOnStyle: llvm, IndentWidth: 8}"

-style-config=- נתיב לספרייה המכילה קובץ .clang-format
תיאור סגנון עיצוב לשימוש עבור עיצוב קוד כאשר בסגנון=פילה.

אפשרויות הכללה/אי הכללה:

-exclude=- רשימה מופרדת בפסיקים של נתיבים שלא ניתן לשנות

-exclude-from=- קובץ המכיל רשימה של נתיבים שלא ניתן לשנות

-include=- רשימה מופרדת בפסיקים של נתיבים שיש לשקול כשינויים

-include-from=- קובץ המכיל רשימה של נתיבים שיש לשקול כשינויים

אפשרויות מודרניזציה:

-סופי-תחביר-בדיקת - בדוק אם תחביר נכון לאחר החלת טרנספורמציות

-for-compilers=- בחר טרנספורמציות המכוונות לצומת של
תכונות שפה הנתמכות על ידי המהדרים הנתונים. לוקח רשימה מופרדת בפסיקים
שֶׁל - .

יכול להיות כל אחד מ: clang, gcc, icc, msvc
הוא [. ]

עזרה - הצג אפשרויות זמינות (-עזרה-נסתר לעוד)

-רשימת עזרה - הצגת רשימה של אפשרויות זמינות (-רשימת עזרה-מוסתרת ל
יותר)

-perf=- לכידת נתוני ביצועים ופלט לספרייה שצוינה.
ברירת מחדל: ./migrate_perf

-לְהִסְתָכֵּן - בחר רמת סיכון מקסימלית:

= בטוח - רק טרנספורמציות בטוחות

=סביר
- אפשר טרנספורמציות שעשויות לשנות את הסמנטיקה (ברירת מחדל)

= risky - אפשר טרנספורמציות שצפויות לשנות את הסמנטיקה

-סיכום - הדפס סיכום טרנספורמציה

-הפך - הצג את הגרסה של תוכנית זו

אפשרויות סדרה:

-serialize-dir=- נתיב לספרייה קיימת בה יש לכתוב
תחליפים בסידרה. התנהגות ברירת המחדל היא כתיבה לספרייה זמנית.

-החלפות בסידרה - סידור החלפות יחידות תרגום לדיסק במקום
שינוי קבצים.

טרנספורמציות:

-הוספה-עקיפה - עשה שימוש במפרט ביטול במידת האפשר

-לופ-המר - עשה שימוש בלולאות מבוססות טווח במידת האפשר

-עובר ערך - העבר פרמטרים לפי ערך במידת האפשר

-replace-auto_ptr - החלף את std::auto_ptr (הוצא משימוש) ב-std::unique_ptr
(נִסיוֹנִי)

-שימוש אוטומטי - שימוש במפרט סוג 'אוטומטי'

-use-nullptr - השתמש במילת מפתח nullptr במידת האפשר

אפשרויות טרנספורמציות:

-עקיפה-מאקרו - זהה והשתמש בפקודות מאקרו שמתרחבות למילת המפתח 'עקוף'.

-user-null-macros=- רשימה מופרדת בפסיקים של שמות מאקרו המוגדרים על ידי המשתמש שמתנהגים
כמו NULL

-p משמש לקריאת מסד נתונים של פקודות קומפילציה.

לדוגמה, זה יכול להיות ספריית CMake build שבה שם קובץ
compile_commands.json קיים (השתמש -DCMAKE_EXPORT_COMPILE_COMMANDS=ON אפשרות CMake
כדי לקבל את הפלט הזה). כאשר לא צוין נתיב בנייה, חיפוש של
compile_commands.json ינוסה דרך כל נתיבי האב של הקלט הראשון
קובץ . לִרְאוֹת: http://clang.llvm.org/docs/HowToSetupToolingForLLVM.html לדוגמה
של הגדרת Clang Tooling על עץ מקור.

... ציין את הנתיבים של קבצי מקור. שבילים אלו הם

חיפש במסד הנתונים של פקודות קומפיל. אם הנתיב של קובץ הוא מוחלט, זה
צריך להצביע על עץ המקור של CMake. אם הנתיב הוא יחסי, הזרם
ספריית העבודה צריכה להיות בעץ המקור של CMake והקובץ חייב להיות ב-a
ספריית משנה של ספריית העבודה הנוכחית. "./" קידומות בקבצים היחסיים
יוסר אוטומטית, אבל שאר הנתיב היחסי חייב להיות סיומת של
נתיב במסד הנתונים של פקודות קומפיל.

דוגמאות:

החל את כל ההמרה על קובץ שאינו דורש ארגומנטים של קומפילציה:

clang-modernize file.cpp

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

לצלצל-מודרניזציה -p לבנות/נתיב -לִכלוֹל פרויקט/נתיב -פוּרמָט -לופ-המר

השתמש גם ב-nullptr וגם במפרט העקיפה, באמצעות git ls-files:

git ls-files '*.cpp' | xargs -I{} צלצול מודרניזציה -p לבנות/נתיב \

-use-nullptr -הוספה-עקיפה -עקיפה-מאקרו {}

החל את כל ההמרות הנתמכות על ידי clang >= 3.0 ו-gcc >= 4.7 על foo.cpp וכל
כותרות כלולות בסרגל:

לצלצל-מודרניזציה -למהדרים=קלאנג-3.0,gcc-4.7 foo.cpp \

-לִכלוֹל בָּר -- -סטד=c++ 11 -איבר

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