gccxml - Online sa Cloud

PROGRAMA:

NAME

gccxml - Lumikha ng XML na representasyon ng mga deklarasyon ng C++.

SINOPSIS

gccxml [mga opsyon] -fxml=

DESCRIPTION

Ang GCC-XML ay nag-parse ng isang C++ na source file dahil ito ay nakikita ng compiler kapag ito ay binuo. Isang madaling-
to-parse XML representasyon ng klase, function, at namespace deklarasyon ay dumped
sa isang tinukoy na file. Binabago ng buong C preprocessing ang file sa isang unit ng pagsasalin ng C++
tulad ng nakikita ng compiler. Nangangahulugan ito na dapat gamitin ng GCC-XML ang parehong pamantayan
library at iba pang mga header file bilang compiler. Maaaring i-configure ang GCC-XML upang gayahin ang anuman
ng ilang tanyag na compiler.

Opsyon

Ang mga sumusunod na opsyon ay magagamit para sa pagpapatakbo ng GCC-XML:

--copyright
I-print ang GCC-XML copyright at exit.

--debug
Mag-print ng karagdagang impormasyon sa pag-debug. Ang pagpipiliang ito ay nagiging sanhi ng GCC-XML na i-print ang
executable na pangalan at command-line na mga argumento na ginamit upang isagawa ang naka-patch na GCC C++
parser. Ito ay kapaki-pakinabang kapag sinusubukang gayahin ang isang hindi sinusuportahang compiler.

-fxml=
Tukuyin ang XML output file. Direktang ipinapasa ang opsyong ito sa naka-patch na GCC
C++ parser. Pinapagana nito ang XML dump at tinutukoy ang pangalan ng output file.

-fxml-start= [,...]
Tukuyin ang isang listahan ng mga panimulang deklarasyon. Direktang ipinapasa ang opsyong ito sa
na-patch na GCC C++ parser. Ito ay makabuluhan lamang kung -fxml= ay tinukoy din. Ito
ay tumutukoy sa isang listahan na pinaghihiwalay ng kuwit ng mga pinangalanang panimulang deklarasyon. Itatapon ng GCC-XML
tanging ang subset ng mga deklarasyon sa unit ng pagsasalin na maaabot
sa pamamagitan ng pagkakasunud-sunod ng mga sanggunian sa pinagmulan mula sa isa sa tinukoy na simula
mga deklarasyon.

--gccxml-compiler
Itakda ang GCCXML_COMPILER sa "xxx".

--gccxml-cxxflags
Itakda ang GCCXML_CXXFLAGS sa "xxx".

--gccxml-executable
Itakda ang GCCXML_EXECUTABLE sa "xxx".

--gccxml-cpp
Itakda ang GCCXML_CPP sa "xxx".

--gccxml-config
Itakda ang GCCXML_CONFIG sa "xxx".

--gccxml-root
Itakda ang GCCXML_ROOT sa "xxx".

--gccxml-gcc-options
Basahin ang mga opsyon sa GCC mula sa file na "xxx". Tinutukoy ng opsyong ito ang isang file kung saan babasahin
mga opsyon na ipapasa sa naka-patch na GCC C++ parser. Ito ay kapaki-pakinabang para sa pagtukoy ng a
mahabang listahan ng mga isamang direktoryo. Ang bawat linya sa file ay nagiging isang opsyon. Walang laman
ang mga linya at linya na nagsisimula sa '#' ay binabalewala.

- Tumulong I-print ang buong tulong at lumabas. Ang buong tulong ay nagpapakita ng karamihan sa dokumentasyong ibinigay ng
ang UNIX man page. Ito ay ibinigay para sa paggamit sa mga non-UNIX na platform, ngunit ito rin
maginhawa kung hindi naka-install ang man page.

--help-html
I-print ang buong tulong sa HTML na format. Ang opsyong ito ay ginagamit ng mga may-akda ng GCC-XML upang tumulong
gumawa ng mga web page.

--lalaki Mag-print ng UNIX man page at lumabas. Ang opsyong ito ay ginagamit ng mga may-akda ng GCC-XML upang bumuo
ang UNIX man page.

--print
I-print ang mga setting ng configuration at lumabas. Ang GCC-XML ay may maraming mga opsyon sa pagsasaayos
tulungan itong gayahin ang isa pang compiler. Ang paggamit sa opsyong ito ay magiging sanhi ng GCC-XML na
i-configure ang sarili nito na parang i-parse nito ang C++ source, ngunit huminto at mag-print
natagpuan ang configuration. Ito ay kapaki-pakinabang para sa pagsuri sa pagsasaayos.

--preprocess
I-preprocess ang input at exit. Ginagaya ng GCC-XML ang proprocessor ng isa pa
compiler. Ang paggamit sa opsyong ito ay magiging sanhi ng GCC-XML na i-configure ang sarili nito na parang ito
pagpunta upang i-parse ang C++ source, ngunit huminto pagkatapos ng preprocessing. Ito ay kapaki-pakinabang para sa
mga problema sa pag-debug na nauugnay sa simulation ng iba pang compiler.

-E Alyas para sa --preprocess.

--bersyon
Ipakita ang banner ng pangalan/bersyon ng programa at lumabas.

Ang iba pang mga flag, gaya ng -I at -D, ay ipinapasa sa naka-patch na GCC C++ parser na maipapatupad.

MGA SETTING

Ang GCC-XML ay idinisenyo upang gayahin ang parser ng compiler habang nagbabasa ng C++ source code. Ang ilan
ang mga setting ng pagsasaayos ay kailangan upang matukoy kung paano gayahin ang isang partikular na compiler ng
pagpili ng gumagamit. Maaaring gamitin ang mga sumusunod na setting para i-configure ang GCC-XML:

GCCXML_COMPILER
Ang C++ compiler na gayahin. Susubukan ng GCC-XML na awtomatikong matukoy
kung paano gayahin ang compiler na tinukoy ng setting na ito. Tinukoy ang compiler
sa pamamagitan ng executable na pangalan nito (gaya ng "g++"). Para sa Visual Studio, ang compiler ay
tinukoy ng "msvc6", "msvc7", "msvc71", o "msvc8" (kung ang "cl" ay ibinigay, GCC-XML
sinusubukang hulaan kung aling VS ang gagamitin).

GCCXML_CXXFLAGS
Ang mga flag para sa C++ compiler ay gayahin. Ang pag-uugali ng karamihan sa mga compiler ay maaaring
iakma sa pamamagitan ng pagtukoy ng mga flag sa command line. Kapag sinubukan ng GCC-XML na
awtomatikong matukoy kung paano gayahin ang isang compiler, ang mga flag na ito ay kinuha sa
pagsasaalang-alang.

GCCXML_CONFIG
Ang configuration file para sa mga karaniwang setting. Kapag madalas ang mga hindi default na setting
ginamit, ito ay maginhawa upang magsulat ng isang solong file na naglalaman ng mga ito. Kapag ang naturang file ay
tinukoy, ito ay babasahin upang i-configure ang anumang mga setting na hindi pa alam. Bawat isa
linya ng file ay binubuo ng isang pagtatalaga ng form na KEY="VALUE" (halimbawa,
GCCXML_COMPILER="g++").

GCCXML_EXECUTABLE
Tukuyin ang naka-patch na GCC C++ parser na maipapatupad. Ang programang GCC-XML gaya ng nakikita ng
ang user ay talagang isang front-end na tumutukoy sa mga flag na kailangan para i-configure ang
patched GCC C++ parser upang gayahin ang isa pang compiler. Tinutukoy ng setting na ito ang
tunay na maipapatupad na tatakbo kapag natukoy na ang mga flag. Ang mga gumagamit ay dapat bihira
kailangang baguhin ang value na ito mula sa default nito.

GCCXML_CPP
Tukuyin ang GCC C preprocessor executable. Ang GCC-XML program na nakikita ng user
ay talagang isang front-end na tumutukoy sa mga flag na kailangan upang i-configure ang patched
GCC C++ parser upang gayahin ang isa pang compiler. Tinutukoy ng setting na ito ang
preprocessor upang tumakbo kasama ang mga flag na natukoy para sa pag-debug
mga layunin. Dapat ay bihirang kailanganin ng mga user na baguhin ang value na ito mula sa default nito.

GCCXML_ROOT
Ang direktoryo ng library ng suporta ng GCC-XML. Dahil ang GCC-XML ay isa lamang C++ parser, ito
hindi maaaring eksaktong duplicate ang functionality ng bawat compiler na sinusubukan nitong gayahin.
Ang ilang mga compiler ay nagbibigay ng karaniwang mga header na may code na hindi direktang hindi maaaring direkta ng GCC-XML
hawakan. Upang malutas ang limitasyong ito, isang library ng suporta ay ibinigay para sa bawat isa
compiler. Binubuo ito ng isang set ng mga header file na ginagamit bilang kapalit ng
mga header ng system ng compiler. Ang mga file na ito ay naglalaman ng mga bahagyang pag-aayos at pagkatapos ay isama ang
kaukulang tunay na header. Ang ugat ng puno ng direktoryo na naglalaman ng mga suportang ito
Ang mga header ng library ay tinukoy ng setting na ito. Ang mga gumagamit ay bihirang kailangang magbago
ang halagang ito mula sa default nito.

GCCXML_FLAGS
Mga flag na ginamit upang gayahin ang iba pang compiler. Kapag pinapatakbo ng GCC-XML ang naka-patch na GCC C++
parser, ang mga flag na ito ay ipinapasa sa programa upang sabihin dito kung paano gayahin ang a
partikular na compiler. Karaniwang awtomatikong nakikita ang setting na ito mula sa isa pa
mga setting, ngunit maaari itong direktang tukuyin ng mga advanced na user. Karamihan sa mga gumagamit ay dapat
huwag subukang baguhin ang halagang ito mula sa awtomatikong pagsasaayos.

GCCXML_USER_FLAGS
Mga karagdagang flag ng user para sa compiler simulation. Kapag pinapatakbo ng GCC-XML ang naka-patch na GCC
C++ parser, ang mga flag na ito ay ipinapasa bilang karagdagan sa mga tinukoy ng GCCXML_FLAGS.
Nagbibigay-daan ito sa mga advanced na user na i-tweak ang compiler simulation habang ginagamit pa rin ang
awtomatikong pagsasaayos ng GCCXML_FLAGS. Ang mga gumagamit ay bihirang kailangang baguhin ito
halaga mula sa default nito.

Mayroong ilang mga paraan kung saan ang mga setting na ito ay na-configure. Nakalista sila dito sa
pagkakasunud-sunod ng pangunguna (pinakamataas muna):

Command-line Options
Maaaring tukuyin ang mga setting sa pamamagitan ng kanilang mga kaukulang opsyon. Kapag ang isang setting ay
Ang kaukulang command-line na opsyon ay ibinigay, ito ay ginagamit pabor sa anumang iba pa
paraan ng pagsasaayos. Kung nakatakda ang GCCXML_CONFIG sa command-line, ang mga setting ay
basahin mula sa file na nauuna nang bahagya lamang kaysa sa ibang command-line
mga pagpipilian.

kapaligiran Variable
Ang mga setting ay na-configure ayon sa pangalan sa kapaligiran. Hindi pa alam ang bawat setting
ay binabasa mula sa isang environment variable na may pangalan nito. Kung ang GCCXML_CONFIG ay itinakda ng
environment, ang mga setting ay binabasa mula sa file na nangunguna sa bahagyang mas mababa
kaysa sa iba pang mga variable ng kapaligiran.

Configuration File
Ang isang paghahanap para sa GCCXML_CONFIG ay isinasagawa. Kung hindi pa naitakda ang GCCXML_CONFIG, an
Ang pagtatangka ay ginawa upang awtomatikong maghanap ng configuration file. Una, kung ang file
$HOME/.gccxml/config ay umiiral, ito ay gagamitin. Pangalawa, kung ang GCC-XML ay isinasagawa
mula sa build directory nito, isang config file mula sa directory na iyon ang gagamitin. Sa wakas,
kung ang isang config file ay matatagpuan sa direktoryo ng library ng suporta ng pag-install, ito ay
gamitin. Kapag nahanap na, babasahin ang anumang hindi kilalang setting mula sa configuration file.

Nanghuhula
Ang mga hula ay ginawa batay sa iba pang mga setting. Kapag naitakda na ang GCCXML_COMPILER, ito ay
ginagamit upang awtomatikong mahanap ang setting para sa GCCXML_FLAGS. Kung hindi ito nakatakda, ang
Ang "CXX" na environment variable ay naka-check bilang isang huling-resort upang mahanap ang setting ng compiler
at tukuyin ang GCCXML_FLAGS.

Karamihan sa mga user ay hindi dapat ayusin ang mga default para sa mga setting na ito. Mayroong default
GCCXML_CONFIG file na ibinigay sa direktoryo ng library ng suporta pagkatapos ng pag-install. Ito
Kino-configure ang GCC-XML para gayahin ang compiler na ginamit para buuin ito.

MGA COMPILERS

Maaaring gayahin ng GCC-XML ang alinman sa mga sumusunod na compiler:

GCC Mga Bersyon 4.2, 4.1, 4.0, 3.4, 3.3, 3.2, 2.95.x

Ng paningin C + +
Bersyon 8, 7.1, 7.0, at 6 (sp5)

Borland, Intel, SGI
dating suportado ngunit hindi na nasubok

Ang mga sumusunod na karagdagang C preprocessor na mga kahulugan ay ibinigay:

-D__GCCXML__=MMmmpp
Ang MM, mm, at pp ay ang major, minor, at patch na mga bersyon ng GCC-XML. Ito
Kinikilala ng simbolo ng preprocessor ang GCC-XML sa source code dahil preprocessed ito.
Maaari itong magamit upang paganahin ang impormasyong partikular sa GCC-XML.

-D__GCCXML_GNUC__=M
Tinukoy sa panloob na GCC parser major na bersyon.

-D__GCCXML_GNUC_MINOR__=m
Tinukoy sa panloob na GCC parser minor na bersyon.

-D__GCCXML_GNUC_PATCHLEVEL__=p
Tinukoy sa panloob na GCC parser patchlevel.

Maaaring gayahin ng mga advanced na user ang iba pang mga compiler sa pamamagitan ng manu-manong pag-configure sa GCCXML_FLAGS
setting. Makipag-ugnayan sa mailing list para sa tulong.

METAINFO

Nagdagdag ang GCC-XML ng bagong attribute sa legal na hanay ng mga attribute ng C/C++. Ang katangian ay
ginamit upang mag-attach ng meta information sa C/C++ source code, na lalabas sa XML
output. Ang syntax para sa pagdedeklara ng isang katangian ay ang mga sumusunod:

__attribute((gccxml( , , ...)))
Dito ay isang naka-quote na string. Dapat mayroong hindi bababa sa isang argumento sa
'gccxml' attribute, ngunit walang pinakamataas na limitasyon sa kabuuang bilang ng mga argumento.
Ang bawat argumento ay na-verify na isang string - kung ang isang hindi string na argumento ay natagpuan, ang
hindi pinapansin ang katangian.

Maglalaman ang XML output para sa elemento ng code na na-tag ng attribute
ang mga sumusunod:

attributes=" ... gccxml( , , ...) ...
Ang 'attributes' XML attribute ay naglalaman ng lahat ng attribute na inilapat sa code element.
Ang bawat argumento ng katangian ay naka-print nang walang kasamang mga panipi, kaya kung an
argument ay naglalaman ng ',' na karakter, ang argumento ay lilitaw na maramihan
argumento.

Ang katangiang 'gccxml' ay maaaring ilapat sa anumang deklarasyon kabilang ang mga istruktura, klase,
mga field, parameter, pamamaraan, function, variable, at typedef. Ang tanging exception ay
na kasalukuyang nasira ang pangangasiwa ng GCC sa elemento ng wikang '__attribute'
enumerations at constructors na may inline na katawan. Maaaring gamitin ang attribute na 'gccxml'
anumang bilang ng beses sa isang ibinigay na deklarasyon.

Bilang isang halimbawa kung paano magagamit ang katangiang ito upang ilakip ang impormasyon ng meta sa C++
mga deklarasyon, isaalang-alang ang sumusunod na macro:

# tukuyin _out_ __attribute((gccxml("out")))
Dito tinukoy ang '_out_' na ang gccxml attribute kung saan ang unang argument
ay ang string "out". Inirerekomenda na ang unang argumento ay gamitin bilang natatangi
string name para sa uri ng meta information na magsisimulang ilapat.

Ngayon ang isang deklarasyon ng pamamaraan ay maaaring isulat tulad ng sumusunod:

walang bisa getInteger(_out_ int& i);
Magiging sanhi ito ng XML output na maglaman ng meta information para sa '_out_'
attribute, sa anyong "gccxml(out)".

Ang paggamit ng attribute na 'gccxml' ay nagbibigay-daan sa meta information na direktang maisama sa loob ng C++
source code, nang hindi nangangailangan ng custom na parser para kunin ang meta information. Ang
Ang katangiang 'gccxml' ay ibinigay para sa kaginhawahan lamang - walang garantiya sa hinaharap
Tatanggapin ng mga bersyon ng GCC ang elemento ng wikang '__attribute' sa paraang walang bug.

COPYRIGHT

GCC-XML - XML ​​na output para sa GCC

Copyright 2002-2012 Kitware, Inc., Insight Consortium

Ang muling pamamahagi at paggamit sa pinagmulan at binary na mga anyo, mayroon man o walang pagbabago, ay
pinahihintulutan sa kondisyon na ang mga sumusunod na kondisyon ay natutugunan:

* Dapat panatilihin ng mga muling pamamahagi ng source code ang abiso sa copyright sa itaas, ang listahang ito ng
kundisyon at ang sumusunod na disclaimer.

* Ang mga muling pamamahagi sa binary na anyo ay dapat na kopyahin ang abiso sa copyright sa itaas, ang listahang ito
ng mga kundisyon at ang sumusunod na disclaimer sa dokumentasyon at/o iba pa
mga materyales na ibinigay kasama ng pamamahagi.

* Ni ang mga pangalan ng Kitware, Inc., ang Insight Software Consortium, o ang mga pangalan
ng kanilang mga nag-aambag ay maaaring gamitin upang i-endorso o i-promote ang mga produktong nagmula rito
software nang walang tiyak na paunang nakasulat na pahintulot.

ANG SOFTWARE NA ITO AY IBINIBIGAY NG MGA NAGHAWA NG COPYRIGHT AT MGA CONTRIBUTOR "AS IS" AT ANUMANG
IPINAHAYAG O IPINAHIWATIG NA MGA WARRANTY, KASAMA, NGUNIT HINDI LIMITADO SA, ANG IPINAHIWATIG NA WARRANTY NG
KINAKAKALANDAAN AT KAANGKUPAN PARA SA ISANG PARTIKULAR NA LAYUNIN AY ITINATAWANG. SA KAHIT KAHIT HINDI MAHALAGA ANG
MANANAGOT ANG MAY-hawak ng COPYRIGHT O MGA CONTRIBUTOR PARA SA ANUMANG DIREKTA, DI DIREKTA, NAGSASAAD, ESPESYAL,
HALIMBAWA, O KINAHIHINUNGANG MGA PINSALA (KASAMA, PERO HINDI LIMITADO SA, PAGBIBIGAY NG
PALIT ANG MGA KALANDA O SERBISYO; PAGKAWALA NG PAGGAMIT, DATA, O KITA; O pagkagambala sa negosyo)
GAANO MAN ANG SANHI AT SA ANUMANG TEORYA NG PANANAGUTAN, SA KONTRATA MAN, MAHIGPIT NA PANANAGUTAN, O
TORT (KASAMA ANG PAGPAPABAYA O IBA) NA NAGMULA SA ANUMANG PARAAN NG PAGGAMIT NITO
SOFTWARE, KAHIT PAY PAYAD NG POSIBLIDAD NG GANYANG PAMAMAHALA.

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

gccxml_cc1plus - Isang GCC parser na na-patch para sa XML dumps ng mga unit ng pagsasalin

Copyright 2002-2012 Kitware, Inc., Insight Consortium

Ang program na ito ay libreng software; maaari mo itong muling ipamahagi at/o baguhin ito sa ilalim ng mga tuntunin ng
ang GNU General Public License na inilathala ng Free Software Foundation; alinman
bersyon 2 ng Lisensya, o (sa iyong opsyon) anumang mas bagong bersyon.

Ang program na ito ay ipinamahagi sa pag-asa na ito ay magiging kapaki-pakinabang, ngunit WALANG ANUMANG WARRANTY;
nang walang kahit na ipinahiwatig na warranty ng MERCHANTABILITY o FITNESS FOR A PARTICULAR PURPOSE.
Tingnan ang GNU General Public License para sa higit pang mga detalye.

Dapat ay nakatanggap ka ng kopya ng GNU General Public License kasama ng programang ito;
kung hindi, sumulat sa
Libreng Software Foundation, Inc.
51 Franklin Street, Fifth Floor
Boston, MA 02110-1301 USA

MAILING LIST

Para sa tulong at talakayan tungkol sa paggamit ng gccxml, isang mailing list ay ibinigay sa
gccxml@www.gccxml.org. Mangyaring basahin muna ang buong dokumentasyon sa http://www.gccxml.org
bago mag-post ng mga tanong sa listahan.

Gamitin ang gccxml online gamit ang mga serbisyo ng onworks.net