gccxml - آنلاین در ابر

برنامه:

نام

gccxml - یک نمایش XML از اعلان های C++ ایجاد کنید.

خلاصه

gccxml [گزینه‌ها] -fxml=

شرح

GCC-XML یک فایل منبع C++ را همانطور که در زمان ساخت توسط کامپایلر دیده می شود، تجزیه می کند. آسان-
برای تجزیه XML نمایش کلاس، تابع و اعلان‌های فضای نام حذف می‌شود
به یک فایل مشخص شده پیش پردازش کامل C فایل را به یک واحد ترجمه C++ تبدیل می کند
همانطور که توسط کامپایلر دیده می شود. این بدان معناست که GCC-XML باید از همان استاندارد استفاده کند
کتابخانه و سایر فایل های هدر به عنوان کامپایلر. GCC-XML را می توان برای شبیه سازی هر کدام پیکربندی کرد
از چندین کامپایلر محبوب

OPTIONS

گزینه های زیر برای اجرای GCC-XML در دسترس هستند:

--کپی رایت
حق چاپ GCC-XML را چاپ کنید و از آن خارج شوید.

- رفع اشکال
اطلاعات رفع اشکال اضافی را چاپ کنید. این گزینه باعث می شود GCC-XML را چاپ کند
نام اجرایی و آرگومان های خط فرمان که برای اجرای وصله شده GCC C++ استفاده می شود
تجزیه کننده این هنگام تلاش برای شبیه سازی یک کامپایلر پشتیبانی نشده مفید است.

-fxml=
فایل خروجی XML را مشخص کنید. این گزینه مستقیماً به GCC اصلاح شده ارسال می شود
تجزیه کننده C++ XML dump را فعال می کند و نام فایل خروجی را مشخص می کند.

-fxml-start= [،...]
فهرستی از اعلامیه های شروع را مشخص کنید. این گزینه به طور مستقیم به
تجزیه کننده GCC C++ وصله شده. فقط در صورتی معنادار است که -fxml= نیز مشخص شده باشد. این
فهرستی از اعلان‌های شروع نام‌گذاری شده با کاما را مشخص می‌کند. GCC-XML تخلیه خواهد شد
فقط زیر مجموعه ای از اعلانات موجود در واحد ترجمه قابل دسترسی است
از طریق دنباله ای از منابع منبع از یکی از شروع های مشخص شده
اعلامیه ها

--gccxml-کامپایلر
GCCXML_COMPILER را روی "xxx" تنظیم کنید.

--gccxml-cxxflags
GCCXML_CXXFLAGS را روی "xxx" تنظیم کنید.

--gccxml-executable
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++. این برای تعیین a مفید است
لیست طولانی از فهرست های شامل. هر خط در فایل به یک گزینه تبدیل می شود. خالی
خطوط و خطوطی که با "#" شروع می شوند نادیده گرفته می شوند.

--کمک راهنمای کامل را چاپ کنید و از آن خارج شوید. راهنمای کامل بیشتر اسناد ارائه شده توسط را نشان می دهد
صفحه مرد یونیکس برای استفاده در پلتفرم های غیر یونیکس ارائه شده است، اما همینطور است
اگر صفحه man نصب نشده باشد راحت است.

--help-html
راهنمای کامل را در قالب HTML چاپ کنید. این گزینه توسط نویسندگان GCC-XML برای کمک استفاده می شود
تولید صفحات وب

--مرد یک صفحه man یونیکس را چاپ کنید و خارج شوید. این گزینه توسط نویسندگان GCC-XML برای تولید استفاده می شود
صفحه مرد یونیکس

--چاپ
تنظیمات پیکربندی چاپ و خروج. 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++"). برای ویژوال استودیو، کامپایلر است
مشخص شده توسط "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 همانطور که توسط
کاربر در واقع یک front-end است که پرچم های مورد نیاز برای پیکربندی را تعیین می کند
تجزیه کننده GCC C++ را برای شبیه سازی کامپایلر دیگری وصله کرد. این تنظیم مشخص می کند
قابل اجرا واقعی برای اجرا پس از تعیین پرچم ها. کاربران به ندرت باید
باید این مقدار را از پیش فرض آن تغییر دهید.

GCCXML_CPP
پیش پردازنده GCC C قابل اجرایی را مشخص کنید. برنامه GCC-XML همانطور که توسط کاربر مشاهده می شود
در واقع یک front-end است که پرچم های مورد نیاز برای پیکربندی پچ شده را تعیین می کند
تجزیه کننده GCC C++ برای شبیه سازی کامپایلر دیگر. این تنظیم مشخص می کند
پیش پردازنده برای اجرا با پرچم هایی که برای اشکال زدایی تعیین شده اند
اهداف کاربران به ندرت باید این مقدار را از پیش‌فرض آن تغییر دهند.

GCCXML_ROOT
فهرست راهنمای کتابخانه پشتیبانی GCC-XML. از آنجایی که GCC-XML تنها یک تجزیه کننده C++ است، آن را
نمی تواند دقیقاً عملکرد هر کامپایلری را که می خواهد شبیه سازی کند، کپی کند.
برخی از کامپایلرها هدرهای استانداردی را با کدهایی ارائه می کنند که GCC-XML مستقیماً نمی تواند آن را انجام دهد
رسیدگی. برای رفع این محدودیت، یک کتابخانه پشتیبانی برای هر کدام ارائه شده است
کامپایلر این شامل مجموعه ای از فایل های هدر است که به جای آن استفاده می شود
هدرهای سیستم کامپایلر این فایل ها شامل ترفندهای جزئی هستند و سپس شامل
هدر واقعی مربوطه ریشه درخت دایرکتوری حاوی این پشتیبانی است
سرصفحه های کتابخانه با این تنظیم مشخص می شود. کاربران به ندرت نیاز به تغییر دارند
این مقدار از پیش فرض آن است.

GCCXML_FLAGS
پرچم هایی برای شبیه سازی کامپایلر دیگر استفاده می شود. وقتی GCC-XML وصله‌شده GCC C++ را اجرا می‌کند
تجزیه کننده، این پرچم ها به برنامه منتقل می شود تا به آن بگوید چگونه a را شبیه سازی کند
کامپایلر خاص این تنظیم معمولاً به طور خودکار از دیگری شناسایی می شود
تنظیمات، اما می تواند به طور مستقیم توسط کاربران پیشرفته مشخص شود. اکثر کاربران باید
سعی نکنید این مقدار را از پیکربندی خودکار تغییر دهید.

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 می تواند هر یک از کامپایلرهای زیر را شبیه سازی کند:

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
قبلا پشتیبانی می شد اما دیگر تست نشده است

تعاریف اضافی پیش پردازنده C زیر ارائه شده است:

-D__GCCXML__=MMmmpp
MM، mm و pp نسخه‌های اصلی، فرعی و پچ GCC-XML هستند. این
نماد پیش پردازشگر GCC-XML را به کد منبع شناسایی می کند که در حال پیش پردازش است.
می توان از آن برای فعال کردن اطلاعات خاص GCC-XML استفاده کرد.

-D__GCCXML_GNUC__=M
به نسخه اصلی تجزیه کننده داخلی GCC تعریف شده است.

-D__GCCXML_GNUC_MINOR__=m
به نسخه فرعی تجزیه کننده داخلی GCC تعریف شده است.

-D__GCCXML_GNUC_PATCHLEVEL__=ص
به سطح وصله تجزیه کننده داخلی GCC تعریف شده است.

کاربران پیشرفته می توانند کامپایلرهای دیگر را با پیکربندی دستی GCCXML_FLAGS شبیه سازی کنند.
تنظیمات. برای راهنمایی با لیست پستی تماس بگیرید.

METAINFO

GCC-XML یک ویژگی جدید به مجموعه قانونی ویژگی های C/C++ اضافه کرده است. صفت است
برای پیوست کردن اطلاعات متا به کد منبع C/C++ استفاده می‌شود که سپس در XML ظاهر می‌شود
خروجی سینتکس برای اعلان یک ویژگی به صورت زیر است:

__ویژگی((gccxml( ، ، ...)))
اینجا یک رشته نقل قول است. باید حداقل یک استدلال برای آن وجود داشته باشد
ویژگی 'gccxml'، اما هیچ محدودیتی برای تعداد کل آرگومان ها وجود ندارد.
هر آرگومان به عنوان یک رشته تأیید می شود - اگر آرگومان غیر رشته ای یافت شود، آن
ویژگی نادیده گرفته می شود.

سپس خروجی XML برای عنصر کد که با ویژگی برچسب گذاری شده است، حاوی خواهد بود
به شرح زیر است:

صفات = " ... gccxml( ، ، ...) ...
ویژگی XML 'ویژگی ها' شامل تمام ویژگی های اعمال شده به عنصر کد است.
هر آرگومان صفت بدون احاطه نقل قول چاپ می شود، بنابراین اگر a
آرگومان حاوی کاراکتر ',' است، آرگومان چندتایی به نظر می رسد
استدلال

ویژگی 'gccxml' را می توان برای هر اعلانی از جمله ساختارها، کلاس ها، اعمال کرد.
فیلدها، پارامترها، متدها، توابع، متغیرها و تایپ‌دف‌ها. تنها استثنا است
که مدیریت GCC از عنصر زبان '__attribute' در حال حاضر برای آن خراب است
شمارش ها و سازنده ها با بدنه خطی. می توان از ویژگی 'gccxml' استفاده کرد
هر تعداد بار در یک اعلامیه معین

به عنوان مثالی از نحوه استفاده از این ویژگی برای پیوست کردن اطلاعات متا به C++
اعلانات، کلان زیر را در نظر بگیرید:

#تعريف كردن _بیرون_ __ویژگی ((gccxml("خارج")))
در اینجا '_out_' به عنوان ویژگی gccxml که در آن اولین آرگومان است، تعریف شده است
رشته "خارج" است. توصیه می شود که آرگومان اول به عنوان یک آرگومان منحصر به فرد استفاده شود
نام رشته برای نوع متا اطلاعات شروع اعمال می شود.

اکنون یک اعلان متد را می توان به صورت زیر نوشت:

از درجه اعتبار ساقط getInteger(_out_ بین& من)؛
این باعث می شود که خروجی XML حاوی اطلاعات متا برای '_out_' باشد.
ویژگی، به شکل "gccxml(out)".

با استفاده از ویژگی "gccxml" اطلاعات متا را قادر می‌سازد تا مستقیماً در C++ گنجانده شوند
کد منبع، بدون نیاز به تجزیه کننده سفارشی برای استخراج اطلاعات متا. در
ویژگی 'gccxml' فقط برای راحتی ارائه شده است - هیچ تضمینی برای آینده وجود ندارد
نسخه‌های GCC عنصر زبان «__attribute» را بدون اشکال می‌پذیرند.

کپی رایت

GCC-XML - خروجی XML برای GCC

حق چاپ 2002-2012 Kitware, Inc., Insight Consortium

توزیع مجدد و استفاده در اشکال منبع و باینری، با یا بدون تغییر، هستند
با رعایت شرایط زیر مجاز است:

* توزیع مجدد کد منبع باید اعلامیه حق چاپ بالا را حفظ کند، این فهرست
شرایط و سلب مسئولیت زیر

* توزیع مجدد به صورت دودویی باید اعلان حق چاپ بالا، این لیست را بازتولید کند
شرایط و سلب مسئولیت زیر در اسناد و/یا موارد دیگر
مواد ارائه شده با توزیع

* نه نام کیت‌ور، شرکت، کنسرسیوم نرم‌افزار اینسایت و نه نام
از مشارکت کنندگان آنها ممکن است برای تأیید یا تبلیغ محصولات به دست آمده از این مورد استفاده شود
نرم افزار بدون اجازه کتبی قبلی خاص

این نرم افزار توسط دارندگان حق نسخه برداری و مشارکت کنندگان "همانطور که هست" و هر گونه دیگری ارائه می شود
ضمانت نامه های صریح یا ضمنی، از جمله، اما نه محدود به، ضمانت های ضمنی
قابلیت خرید و فروش و تناسب برای یک هدف خاص سلب مسئولیت می شود. در هیچ موردی نباید
دارنده یا مشارکت کنندگان حق نسخه برداری در قبال هر نوع مستقیم، غیر مستقیم، اتفاقی، خاص،
خسارات مثال زدنی یا تبعی (شامل، اما نه محدود به، خرید
کالاها یا خدمات جایگزین؛ از دست دادن استفاده، داده یا سود؛ یا وقفه کسب و کار)
به هر حال و بر اساس هر نظریه مسئولیت، خواه در قرارداد، مسئولیت دقیق، یا
جرم (شامل سهل انگاری یا در غیر این صورت) که به هر نحوی ناشی از استفاده از این
نرم افزار ، حتی اگر به احتمال زیاد چنین خسارتی توصیه شود.

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

gccxml_cc1plus - یک تجزیه‌کننده GCC وصله‌شده برای تخلیه‌های XML واحدهای ترجمه

حق چاپ 2002-2012 Kitware, Inc., Insight Consortium

این برنامه نرم افزار رایگان است. می توانید آن را مجدداً توزیع کنید و/یا آن را تحت شرایط تغییر دهید
مجوز عمومی عمومی گنو که توسط بنیاد نرم افزار آزاد منتشر شده است. یا
نسخه 2 مجوز، یا (به انتخاب شما) هر نسخه بعدی.

این برنامه به این امید که مفید باشد، اما بدون ضمانت توزیع شده است.
حتی بدون ضمانت ضمنی تجارت یا تناسب برای یک هدف خاص.
برای جزئیات بیشتر به مجوز عمومی عمومی گنو مراجعه کنید.

شما باید یک نسخه از مجوز عمومی عمومی گنو را همراه با این برنامه دریافت کرده باشید.
اگر نه، به
بنیاد نرم افزار رایگان، Inc.
خیابان فرانکلین 51، طبقه پنجم
بوستون، MA 02110-1301 ایالات متحده آمریکا

ارسال نامه لیست

برای کمک و بحث در مورد استفاده از gccxml، یک لیست پستی ارائه شده است
[ایمیل محافظت شده]. لطفا ابتدا مستندات کامل را در http://www.gccxml.org
قبل از ارسال سوالات به لیست

با استفاده از خدمات onworks.net از gccxml به صورت آنلاین استفاده کنید