gccxml - Online in de cloud

PROGRAMMA:

NAAM

gccxml - Maak een XML-representatie van C++-declaraties.

KORTE INHOUD

gccxml [opties] -fxml=

PRODUCTBESCHRIJVING

GCC-XML ontleedt een C++-bronbestand zoals het wordt gezien door de compiler wanneer het wordt gebouwd. Een makkelijke-
to-parse XML-representatie van de klasse-, functie- en naamruimtedeclaraties wordt gedumpt
naar een opgegeven bestand. Volledige C-voorverwerking transformeert het bestand in een C++-vertaaleenheid
zoals gezien door de compiler. Dit betekent dat GCC-XML gebruik moet maken van dezelfde standaard
bibliotheek en andere headerbestanden als de compiler. GCC-XML kan worden geconfigureerd om elke simulatie te simuleren
van verschillende populaire compilers.

OPTIES

De volgende opties zijn beschikbaar voor het uitvoeren van GCC-XML:

--auteursrechten
Druk het GCC-XML-copyright af en sluit af.

--debuggen
Druk extra foutopsporingsinformatie af. Deze optie zorgt ervoor dat GCC-XML het
uitvoerbare naam en opdrachtregelargumenten die worden gebruikt om de gepatchte GCC C++ uit te voeren
ontleder. Dit is handig wanneer u probeert een niet-ondersteunde compiler te simuleren.

-fxml=
Geef het XML-uitvoerbestand op. Deze optie wordt direct doorgegeven aan de gepatchte GCC
C++-parser. Het maakt de XML-dump mogelijk en specificeert de naam van het uitvoerbestand.

-fxml-start= [,...]
Geef een lijst met startaangiften op. Deze optie wordt direct doorgegeven aan de
gepatchte GCC C++-parser. Het heeft alleen betekenis als ook -fxml= is opgegeven. Dit
specificeert een door komma's gescheiden lijst van benoemde startdeclaraties. GCC-XML zal dumpen
alleen de subset van de declaraties in de vertaaleenheid die bereikbaar is
via een reeks bronverwijzingen vanaf een van de gespecificeerde beginpunten
verklaringen.

--gccxml-compiler
Stel GCCXML_COMPILER in op "xxx".

--gccxml-cxxflags
Stel GCCXML_CXXFLAGS in op "xxx".

--gccxml-uitvoerbaar
Stel GCCXML_EXECUTABLE in op "xxx".

--gccxml-cpp
Stel GCCXML_CPP in op "xxx".

--gccxml-config
Stel GCCXML_CONFIG in op "xxx".

--gccxml-root
Stel GCCXML_ROOT in op "xxx".

--gccxml-gcc-opties
Lees GCC-opties uit bestand "xxx". Deze optie specificeert een bestand waaruit gelezen moet worden
opties om door te geven aan de gepatchte GCC C++-parser. Dit is handig voor het specificeren van een
lange lijst met directory's. Elke regel in het bestand wordt één optie. Leeg
regels en regels die beginnen met '#' worden genegeerd.

--help Druk de volledige hulp af en sluit af. De volledige help geeft de meeste documentatie weer die wordt geleverd door
de UNIX man-pagina. Het is bedoeld voor gebruik op niet-UNIX-platforms, maar is dat ook
handig als de man-pagina niet is geïnstalleerd.

--help-html
Druk volledige hulp af in HTML-formaat. Deze optie wordt gebruikt door GCC-XML-auteurs om te helpen
webpagina's maken.

--Mens Druk een UNIX man-pagina af en sluit af. Deze optie wordt gebruikt door GCC-XML-auteurs om
de UNIX man-pagina.

--afdrukken
Druk de configuratie-instellingen af ​​en sluit af. GCC-XML heeft veel configuratie-opties om
help het een andere compiler te simuleren. Het gebruik van deze optie zorgt ervoor dat GCC-XML
configureert zichzelf alsof het de C++-broncode gaat ontleden, maar stopt en drukt af
de gevonden configuratie. Dit is handig om de configuratie te controleren.

--voorverwerken
Verwerk de invoer en uitvoer voor. GCC-XML simuleert de proprocessor van een ander
compiler. Als u deze optie gebruikt, zal GCC-XML zichzelf configureren alsof het zo is
gaat de C ++ -bron ontleden, maar stopt na voorbewerking. Dit is handig voor
foutopsporingsproblemen met betrekking tot simulatie van de andere compiler.

-E Alias ​​voor --preprocess.

--versie
Toon banner programmanaam/versie en sluit af.

Andere vlaggen, zoals -I en -D, worden doorgegeven aan het gepatchte uitvoerbare bestand van de GCC C++-parser.

INSTELLINGEN

GCC-XML is ontworpen om de parser van een compiler te simuleren tijdens het lezen van de C++-broncode. Sommige
configuratie-instellingen zijn nodig om te bepalen hoe een bepaalde compiler moet worden gesimuleerd
de keuze van de gebruiker. De volgende instellingen kunnen worden gebruikt om GCC-XML te configureren:

GCCXML_COMPILER
De C++-compiler die moet worden gesimuleerd. GCC-XML zal proberen om automatisch te bepalen
hoe de compiler te simuleren die door deze instelling wordt gespecificeerd. De compiler is opgegeven
door de naam van het uitvoerbare bestand (zoals "g++"). Voor Visual Studio is de compiler
gespecificeerd door "msvc6", "msvc7", "msvc71" of "msvc8" (als "cl" is opgegeven, GCC-XML
probeert te raden welke VS te gebruiken).

GCCXML_CXXFLAGS
De vlaggen voor de C++-compiler die moet worden gesimuleerd. Het gedrag van de meeste compilers kan
worden aangepast door vlaggen op de opdrachtregel op te geven. Wanneer GCC-XML probeert om
automatisch bepalen hoe een compiler moet worden gesimuleerd, wordt rekening gehouden met deze vlaggen
overweging.

GCCXML_CONFIG
Het configuratiebestand voor algemene instellingen. Wanneer niet-standaardinstellingen vaak zijn
gebruikt, is het handig om een ​​enkel bestand te schrijven dat ze bevat. Wanneer zo'n bestand is
opgegeven, wordt het gelezen om instellingen te configureren die nog niet bekend zijn. Elk
regel van het bestand bestaat uit één toewijzing van de vorm KEY="VALUE" (bijvoorbeeld
GCCXML_COMPILER="g++").

GCCXML_EXECUTABLE
Geef het gepatchte uitvoerbare bestand van de GCC C++-parser op. Het GCC-XML-programma zoals gezien door de
user is eigenlijk een front-end die de vlaggen bepaalt die nodig zijn om de
gepatchte GCC C++-parser om een ​​andere compiler te simuleren. Deze instelling specificeert de
real uitvoerbaar om uit te voeren zodra de vlaggen zijn bepaald. Gebruikers zouden dat zelden moeten doen
moet deze waarde wijzigen ten opzichte van de standaardwaarde.

GCCXML_CPP
Specificeer het uitvoerbare bestand van de GCC C-preprocessor. Het GCC-XML-programma zoals gezien door de gebruiker
is eigenlijk een front-end die de vlaggen bepaalt die nodig zijn om de gepatchte
GCC C++ parser om een ​​andere compiler te simuleren. Deze instelling specificeert de
preprocessor om te werken met de vlaggen die zijn bepaald voor foutopsporing
doeleinden. Gebruikers hoeven deze standaardwaarde zelden te wijzigen.

GCCXML_ROOT
De GCC-XML-ondersteuningsbibliotheekdirectory. Aangezien GCC-XML slechts één C++-parser is, is het
kan niet precies de functionaliteit dupliceren van elke compiler die het probeert te simuleren.
Sommige compilers bieden standaard headers met code die GCC-XML niet rechtstreeks kan
hendel. Om deze beperking te omzeilen, is er voor elk een ondersteuningsbibliotheek
compiler. Dit bestaat uit een set headerbestanden die worden gebruikt in plaats van de
systeemheaders van de compiler. Deze bestanden bevatten kleine aanpassingen en bevatten vervolgens de
overeenkomstige echte kop. De hoofdmap van de mappenboom die deze ondersteuning bevat
bibliotheekheaders wordt gespecificeerd door deze instelling. Gebruikers hoeven zelden te veranderen
deze waarde van de standaardwaarde.

GCCXML_FLAGS
Vlaggen die worden gebruikt om de andere compiler te simuleren. Wanneer GCC-XML het gepatchte GCC C++
parser, worden deze vlaggen doorgegeven aan het programma om te vertellen hoe een
bepaalde compiler. Deze instelling wordt meestal automatisch gedetecteerd door de andere
instellingen, maar kan direct worden opgegeven door ervaren gebruikers. De meeste gebruikers zouden dat moeten doen
probeer deze waarde niet te wijzigen vanuit de automatische configuratie.

GCCXML_USER_FLAGS
Extra gebruikersvlaggen voor compilersimulatie. Wanneer GCC-XML het gepatchte GCC
C++-parser, worden deze vlaggen doorgegeven naast de vlaggen die zijn gespecificeerd door GCCXML_FLAGS.
Hierdoor kunnen geavanceerde gebruikers de compilersimulatie aanpassen terwijl ze nog steeds het
automatische configuratie van GCCXML_FLAGS. Gebruikers hoeven dit zelden te wijzigen
waarde van de standaardwaarde.

Er zijn verschillende manieren waarop deze instellingen worden geconfigureerd. Ze staan ​​hier vermeld in
volgorde van prioriteit (hoogste eerst):

Opdrachtregel Opties
Instellingen kunnen worden gespecificeerd door hun corresponderende opties. Wanneer een instelling is
overeenkomstige opdrachtregeloptie wordt verstrekt, wordt deze in het voordeel gebruikt boven alle andere
middel van configuratie. Als GCCXML_CONFIG is ingesteld op de opdrachtregel, zijn de instellingen dat ook
lees uit het bestand met voorrang net iets lager dan andere opdrachtregel
opties.

Milieu Variabelen
Instellingen worden op naam geconfigureerd in de omgeving. Elke instelling is nog niet bekend
wordt gelezen uit een omgevingsvariabele met zijn naam. Als GCCXML_CONFIG is ingesteld door de
omgeving worden instellingen uit het bestand gelezen met voorrang net iets lager
dan andere omgevingsvariabelen.

Configuratie Bestanden
Er wordt gezocht naar GCCXML_CONFIG. Als GCCXML_CONFIG nog niet is ingesteld, an
er wordt geprobeerd automatisch een configuratiebestand te vinden. Ten eerste, als het bestand
$HOME/.gccxml/config bestaat, het zal worden gebruikt. Ten tweede, als GCC-XML wordt uitgevoerd
vanuit de build-directory wordt een configuratiebestand uit die directory gebruikt. Eindelijk,
als er een configuratiebestand wordt gevonden in de directory van de ondersteuningsbibliotheek van de installatie, zal dat zo zijn
worden gebruikt. Eenmaal gevonden, worden eventuele onbekende instellingen uit het configuratiebestand gelezen.

gissen
Er worden gissingen gemaakt op basis van andere instellingen. Zodra GCCXML_COMPILER is ingesteld, is dit het geval
gebruikt om automatisch de instelling voor GCCXML_FLAGS te vinden. Als deze niet is ingesteld, wordt de
De omgevingsvariabele "CXX" wordt gecontroleerd als laatste redmiddel om de compilerinstelling te vinden
en bepaal GCCXML_FLAGS.

De meeste gebruikers hoeven de standaardinstellingen voor deze instellingen niet aan te passen. Er is een standaard
GCCXML_CONFIG-bestand dat na installatie wordt geleverd in de directory van de ondersteuningsbibliotheek. Het
configureert GCC-XML om de compiler te simuleren die werd gebruikt om het te bouwen.

COMPILEERDERS

GCC-XML kan elk van de volgende compilers simuleren:

GCC Versies 4.2, 4.1, 4.0, 3.4, 3.3, 3.2, 2.95.x

Visual C + +
Versies 8, 7.1, 7.0 en 6 (sp5)

Borland, Intel, SGI
voorheen ondersteund maar niet meer getest

De volgende extra C-preprocessordefinities zijn beschikbaar:

-D__GCCXML__=MMmmpp
MM, mm en pp zijn de primaire, secundaire en patchversies van GCC-XML. Dit
preprocessor-symbool identificeert GCC-XML met de broncode terwijl deze wordt voorverwerkt.
Het kan worden gebruikt om GCC-XML-specifieke informatie in te schakelen.

-D__GCCXML_GNUC__=M
Gedefinieerd naar de hoofdversie van de interne GCC-parser.

-D__GCCXML_GNUC_MINOR__=m
Gedefinieerd als secundaire versie van de interne GCC-parser.

-D__GCCXML_GNUC_PATCHLEVEL__=pag
Gedefinieerd op patchniveau van de interne GCC-parser.

Gevorderde gebruikers kunnen andere compilers simuleren door de GCCXML_FLAGS handmatig te configureren
instelling. Neem contact op met de mailinglijst voor hulp.

METAINFO

GCC-XML heeft een nieuw attribuut toegevoegd aan de wettelijke set van C/C++ attributen. Het attribuut is
gebruikt om meta-informatie aan de C/C++-broncode te koppelen, die vervolgens in de XML zal verschijnen
uitvoer. De syntax voor het declareren van een attribuut is als volgt:

__kenmerk((gccxml( , , ...)))
Hier is een tekenreeks tussen aanhalingstekens. Er moet ten minste één argument zijn voor de
'gccxml' attribuut, maar er is geen bovengrens aan het totale aantal argumenten.
Elk argument wordt geverifieerd als een tekenreeks - als een niet-tekenreeksargument wordt gevonden, wordt het
attribuut wordt genegeerd.

De XML-uitvoer voor het code-element dat is getagd met het attribuut zal dan bevatten
het volgende:

attributen=" ... gccxml( , , ...) ...
Het XML-attribuut 'attributen' bevat alle attributen die op het code-element zijn toegepast.
Elk argument van het attribuut wordt afgedrukt zonder aanhalingstekens, dus als een
argument het ','-teken bevat, lijkt het argument meervoudig te zijn
argumenten.

Het 'gccxml' attribuut kan worden toegepast op elke declaratie inclusief structs, klassen,
velden, parameters, methoden, functies, variabelen en typedefs. De enige uitzondering is
waarvoor de verwerking door GCC van het taalelement '__attribute' momenteel is onderbroken
opsommingen en constructors met een inlined body. Het 'gccxml'-attribuut kan worden gebruikt
een willekeurig aantal keren op een bepaalde verklaring.

Als voorbeeld van hoe dit attribuut kan worden gebruikt om meta-informatie aan C++ te koppelen
declaraties, overweeg dan de volgende macro:

#define _uit_ __kenmerk((gccxml("uit")))
Hier is '_out_' gedefinieerd als het gccxml-attribuut waar het eerste argument is
is de tekenreeks "uit". Het wordt aanbevolen om het eerste argument als een uniek argument te gebruiken
tekenreeksnaam voor het type meta-informatie wordt toegepast.

Nu kan een methodedeclaratie als volgt worden geschreven:

komen te vervallen getInteger(_uit_ int& i);
Hierdoor bevat de XML-uitvoer meta-informatie voor de '_out_'
attribuut, in de vorm "gccxml(out)".

Door het 'gccxml'-attribuut te gebruiken, kan meta-informatie rechtstreeks in C++ worden opgenomen
broncode, zonder dat een aangepaste parser nodig is om de meta-informatie te extraheren. De
Het kenmerk 'gccxml' wordt alleen voor het gemak verstrekt - er is geen garantie dat dit in de toekomst zal gebeuren
versies van GCC accepteren het taalelement '__attribute' op een foutloze manier.

COPYRIGHT

GCC-XML - XML-uitvoer voor GCC

Copyright 2002-2012 Kitware, Inc., Insight Consortium

Herdistributie en gebruik in bron- en binaire vorm, met of zonder wijziging, zijn
toegestaan ​​mits aan de volgende voorwaarden wordt voldaan:

* Herdistributies van de broncode moeten de bovenstaande copyrightvermelding bevatten, deze lijst met:
voorwaarden en de volgende disclaimer.

* Herdistributies in binaire vorm moeten de bovenstaande copyrightmelding, deze lijst, reproduceren
van voorwaarden en de volgende disclaimer in de documentatie en/of andere
materialen die bij de distributie worden geleverd.

* Noch de namen van Kitware, Inc., het Insight Software Consortium, noch de namen
van hun bijdragers kunnen worden gebruikt om hiervan afgeleide producten te onderschrijven of te promoten
software zonder specifieke voorafgaande schriftelijke toestemming.

DEZE SOFTWARE WORDT GELEVERD DOOR DE HOUDERS EN BIJDRAGERS VAN HET AUTEURSRECHT "AS IS" EN EVENTUELE
UITDRUKKELIJKE OF IMPLICIETE GARANTIES, INCLUSIEF, MAAR NIET BEPERKT TOT, DE IMPLICIETE GARANTIES VAN
VERKOOPBAARHEID EN GESCHIKTHEID VOOR EEN BEPAALD DOEL WORDEN AFGEWEZEN. IN GEEN GEVAL ZAL DE
AUTEURSRECHTHOUDER OF MEDEWERKERS ZIJN AANSPRAKELIJK VOOR ENIGE DIRECTE, INDIRECTE, INCIDENTELE, SPECIALE,
VOORBEELDSCHADE OF GEVOLGSCHADE (INCLUSIEF, MAAR NIET BEPERKT TOT, AANKOOP VAN
VERVANGENDE GOEDEREN OF DIENSTEN; VERLIES VAN GEBRUIK, GEGEVENS OF WINST; OF BEDRIJFSONDERBREKING)
ONGEACHT DE OORZAAK EN OP ELKE THEORIE VAN AANSPRAKELIJKHEID, IN CONTRACT, STRIKTE AANSPRAKELIJKHEID OF
ONRECHTMATIGE DAAD (INCLUSIEF NALATIGHEID OF ANDERSZINS) DIE OP ENIGE WIJZE VOORTVLOEIT UIT HET GEBRUIK VAN DIT
SOFTWARE, ZELFS INDIEN OP DE HOOGTE VAN DE MOGELIJKHEID VAN DERGELIJKE SCHADE.

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

gccxml_cc1plus - Een GCC-parser gepatcht voor XML-dumps van vertaaleenheden

Copyright 2002-2012 Kitware, Inc., Insight Consortium

Dit programma is gratis software; u kunt het opnieuw distribueren en/of wijzigen onder de voorwaarden van:
de GNU General Public License zoals gepubliceerd door de Free Software Foundation; of
versie 2 van de Licentie, of (naar uw keuze) een latere versie.

Dit programma wordt verspreid in de hoop dat het nuttig zal zijn, maar ZONDER ENIGE GARANTIE;
zonder zelfs de impliciete garantie van VERKOOPBAARHEID of GESCHIKTHEID VOOR EEN BEPAALD DOEL.
Zie de GNU General Public License voor meer details.

U zou samen met dit programma een kopie van de GNU General Public License moeten hebben ontvangen;
zo niet, schrijf dan naar de
Free Software Foundation, Inc.
Franklin Street 51, vijfde verdieping
Boston, MA 02110-1301 VS

MAILEN LIJST

Voor hulp en discussie over het gebruik van gccxml vindt u een mailinglijst op
[e-mail beveiligd]. Lees eerst de volledige documentatie op http://www.gccxml.org
voordat u vragen op de lijst plaatst.

Gebruik gccxml online met onworks.net-services