gccxml - عبر الإنترنت في السحابة

برنامج:

اسم

com.gccxml - إنشاء تمثيل XML لإعلانات C ++.

موجز

gccxml [خيارات] -fxml =

الوصف

يوزع GCC-XML ملف مصدر C ++ كما يراه المترجم عند إنشائه. سهل-
لتحليل تمثيل XML للفئة والوظيفة وإعلانات مساحة الاسم
إلى ملف محدد. المعالجة المسبقة للغة C الكاملة تحول الملف إلى وحدة ترجمة C ++
كما يراه المترجم. هذا يعني أن GCC-XML يجب أن يستخدم نفس المعيار
مكتبة وملفات الرأس الأخرى كمترجم. يمكن تكوين GCC-XML لمحاكاة أي
من العديد من المجمعين المشهورين.

OPTIONS

تتوفر الخيارات التالية لتشغيل GCC-XML:

--حقوق النشر
طباعة حقوق النشر GCC-XML والخروج.

--Debug
اطبع معلومات تصحيح الأخطاء الإضافية. يؤدي هذا الخيار إلى قيام GCC-XML بطباعة ملف
الاسم القابل للتنفيذ ووسائط سطر الأوامر المستخدمة لتنفيذ GCC C ++ المصححة
محلل. هذا مفيد عند محاولة محاكاة مترجم غير مدعوم.

-fxml =
حدد ملف إخراج XML. يتم تمرير هذا الخيار مباشرة إلى GCC المصححة
محلل C ++. يمكّن تفريغ 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- الجذر
قم بتعيين 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 كما يراه
user هو في الواقع واجهة أمامية تحدد العلامات اللازمة لتهيئة
محلل 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 بعد ، فسيتم تعيين ملف
جرت محاولة للعثور على ملف التكوين تلقائيًا. أولا ، إذا كان الملف
$ HOME / .gccxml / config موجود ، سيتم استخدامه. ثانيًا ، إذا تم تنفيذ GCC-XML
من دليل البناء الخاص به ، سيتم استخدام ملف التكوين من هذا الدليل. أخيراً،
إذا تم العثور على ملف التكوين في دليل مكتبة دعم التثبيت ، فسيتم
يستخدم. بمجرد العثور عليها ، تتم قراءة أي إعدادات غير معروفة من ملف التكوين.

التخمين
يتم إجراء التخمينات بناءً على إعدادات أخرى. بمجرد تعيين GCCXML_COMPILER ، يتم تعيينه
يُستخدم للبحث تلقائيًا عن إعداد GCCXML_FLAGS. إذا لم يتم تعيينه ، فإن ملف
يتم تحديد متغير البيئة "CXX" كحل أخير للعثور على إعداد المحول البرمجي
وتحديد GCCXML_FLAGS.

يجب ألا يضطر معظم المستخدمين إلى ضبط الإعدادات الافتراضية لهذه الإعدادات. هناك تقصير
يتم توفير ملف GCCXML_CONFIG في دليل مكتبة الدعم بعد التثبيت. هو - هي
يكوّن GCC-XML لمحاكاة المترجم الذي تم استخدامه في إنشائه.

المترجمون

يمكن لـ GCC-XML محاكاة أي من المجمعين التاليين:

الخليج الإصدارات 4.2، 4.1، 4.0، 3.4، 3.3، 3.2، 2.95.x

مرئي C + +
الإصدارات 8 و 7.1 و 7.0 و 6 (sp5)

بورلاند ، إنتل، SGI
مدعومًا سابقًا ولكن لم يعد يتم اختباره

يتم توفير تعريفات المعالج الأولي C الإضافية التالية:

-D__GCCXML __ = MMmmpp
MM و mm و pp هي الإصدارات الرئيسية والثانوية والمرقعة من GCC-XML. هذا
يعرّف رمز المعالج المسبق GCC-XML إلى كود المصدر أثناء معالجته مسبقًا.
يمكن استخدامه لتمكين المعلومات الخاصة بـ GCC-XML.

-D__GCCXML_GNUC __ = م
مُعرَّفة للإصدار الرئيسي المحلل اللغوي الداخلي لدول مجلس التعاون الخليجي.

-D__GCCXML_GNUC_MINOR __ = م
مُعرَّف للإصدار الثانوي للمحلل اللغوي الداخلي لدول مجلس التعاون الخليجي.

-D__GCCXML_GNUC_PATCHLEVEL __ = ص
محددة لمستوى patchlevel المحلل اللغوي الداخلي لدول مجلس التعاون الخليجي.

يمكن للمستخدمين المتقدمين محاكاة المجمعين الآخرين عن طريق تكوين GCCXML_FLAGS يدويًا
جلسة. اتصل بالقائمة البريدية للحصول على المساعدة.

ميتينفو

أضاف GCC-XML سمة جديدة إلى المجموعة القانونية لسمات C / C ++. السمة هي
تُستخدم لإرفاق معلومات التعريف بكود مصدر C / C ++ ، والذي سيظهر بعد ذلك في XML
انتاج. تكون صيغة التصريح عن السمة كما يلي:

__attribute ((gccxml ( و و ...))))
هنا هي سلسلة مقتبسة. يجب أن تكون هناك حجة واحدة على الأقل لـ
السمة "gccxml" ، لكن لا يوجد حد أعلى لإجمالي عدد الوسائط.
يتم التحقق من أن كل وسيطة عبارة عن سلسلة - إذا تم العثور على وسيطة غير سلسلة ، فسيتم التحقق من
السمة تم تجاهلها.

سيحتوي بعد ذلك إخراج XML لعنصر التعليمات البرمجية الذي تم وضع علامة عليه بالسمة
ما يلي:

السمات = " gccxml ( و و ...)
تحتوي سمة XML الخاصة بـ "السمات" على كافة السمات المطبقة على عنصر التعليمات البرمجية.
تتم طباعة كل وسيطة للسمة بدون إحاطة علامات الاقتباس ، لذلك إذا كان ملف
تحتوي الوسيطة على الحرف "،" ، ستظهر الوسيطة لتكون متعددة
الحجج.

يمكن تطبيق السمة "gccxml" على أي تصريح بما في ذلك البنيات والفئات
الحقول والمعلمات والأساليب والوظائف والمتغيرات والمحرفات. الاستثناء الوحيد هو
أن معالجة GCC لعنصر اللغة "__attribute" معطلة حاليًا
التعدادات والمنشآت بجسم مضمن. يمكن استخدام السمة "gccxml"
أي عدد من المرات في إعلان معين.

كمثال على كيفية استخدام هذه السمة لإرفاق معلومات التعريف بـ C ++
الإعلانات ، ضع في اعتبارك الماكرو التالي:

# تعريف _خارج_ __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 Consortium أو الأسماء
قد يتم استخدام من مساهميهم لتأييد أو ترويج المنتجات المشتقة من هذا
برنامج بدون إذن كتابي محدد مسبق.

يتم توفير هذا البرنامج من قبل حاملي حقوق الطبع والنشر والمساهمين "كما هي" وأي
الضمانات الصريحة أو الضمنية ، بما في ذلك ، على سبيل المثال لا الحصر ، الضمانات الضمنية لـ
يتم التنصل من القابلية للتسويق والملاءمة لغرض معين. لا يجوز في أي حال من الأحوال أن
يكون حامل حقوق الطبع والنشر أو المساهمون مسؤولين عن أي مباشر أو غير مباشر أو عرضي أو خاص أو
الأضرار النموذجية أو اللاحقة (بما في ذلك ، على سبيل المثال لا الحصر ، شراء
السلع أو الخدمات البديلة ؛ فقدان الاستخدام أو البيانات أو الأرباح ؛ أو انقطاع الأعمال)
مهما كان السبب وفي أي نظرية للمسؤولية ، سواء في العقد أو المسؤولية الصارمة ، أو
الضرر (بما في ذلك الإهمال أو غير ذلك) الذي ينشأ بأي طريقة ناتجة عن استخدام هذا
البرنامج ، حتى لو تم إخطاره بإمكانية حدوث مثل هذا الضرر.

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

gccxml_cc1plus - محلل دول مجلس التعاون الخليجي مصحح لتفريغ XML لوحدات الترجمة

حقوق النشر 2002-2012 Kitware، Inc.، Insight Consortium

هذا البرنامج هو برنامج مجاني. يمكنك إعادة توزيعه و / أو تعديله بموجب شروط
رخصة جنو العمومية كما نشرتها مؤسسة البرمجيات الحرة ؛ إما
الإصدار 2 من الترخيص ، أو (حسب اختيارك) أي إصدار لاحق.

يتم توزيع هذا البرنامج على أمل أن يكون مفيدًا ، ولكن بدون أي ضمان ؛
حتى بدون الضمان الضمني لقابلية التسويق أو الملاءمة لغرض معين.
انظر رخصة جنو العمومية لمزيد من التفاصيل.

يجب أن تكون قد تلقيت نسخة من رخصة جنو العمومية مع هذا البرنامج ؛
إذا لم يكن كذلك ، فاكتب إلى
مؤسسة البرمجيات الحرة ، وشركة
51 شارع فرانكلين ، الدور الخامس
بوسطن ، ماساتشوستس 02110-1301 الولايات المتحدة الأمريكية

المراسلات قائمة

للمساعدة والمناقشة حول استخدام gccxml ، تتوفر قائمة بريدية على
[البريد الإلكتروني محمي]. يرجى قراءة الوثائق الكاملة أولاً على http://www.gccxml.org
قبل نشر الأسئلة في القائمة.

استخدم gccxml عبر الإنترنت باستخدام خدمات onworks.net