gccxml – Online in der Cloud

PROGRAMM:

NAME/FUNKTION

gccxml - Erstellen Sie eine XML-Darstellung von C++-Deklarationen.

ZUSAMMENFASSUNG

gccxml [Optionen] -fxml=

BESCHREIBUNG

GCC-XML analysiert eine C++-Quelldatei so, wie sie vom Compiler beim Erstellen gesehen wird. Ein einfaches-
Die zu analysierende XML-Darstellung der Klassen-, Funktions- und Namespace-Deklarationen wird ausgegeben
in eine angegebene Datei. Durch die vollständige C-Vorverarbeitung wird die Datei in eine C++-Übersetzungseinheit umgewandelt
wie vom Compiler gesehen. Das bedeutet, dass GCC-XML denselben Standard verwenden sollte
Bibliothek und andere Header-Dateien als Compiler. GCC-XML kann so konfiguriert werden, dass es beliebige simuliert
mehrerer beliebter Compiler.

OPTIONAL

Für die Ausführung von GCC-XML stehen folgende Optionen zur Verfügung:

--Urheberrechte ©
Drucken Sie das GCC-XML-Copyright aus und beenden Sie den Vorgang.

--debuggen
Drucken Sie zusätzliche Debugging-Informationen. Diese Option bewirkt, dass GCC-XML das druckt
Name der ausführbaren Datei und Befehlszeilenargumente, die zum Ausführen des gepatchten GCC C++ verwendet werden
Parser. Dies ist nützlich, wenn Sie versuchen, einen nicht unterstützten Compiler zu simulieren.

-fxml=
Geben Sie die XML-Ausgabedatei an. Diese Option wird direkt an den gepatchten GCC weitergegeben
C++-Parser. Es aktiviert den XML-Dump und gibt den Namen der Ausgabedatei an.

-fxml-start= [,...]
Geben Sie eine Liste von Startdeklarationen an. Diese Option wird direkt an die weitergegeben
gepatchter GCC C++-Parser. Es ist nur sinnvoll, wenn auch -fxml= angegeben ist. Das
Gibt eine durch Kommas getrennte Liste benannter Startdeklarationen an. GCC-XML wird ausgegeben
Nur die Teilmenge der Deklarationen in der Übersetzungseinheit ist erreichbar
durch eine Folge von Quellenverweisen von einem der angegebenen Startpunkte
Erklärungen.

--gccxml-compiler
Setzen Sie GCCXML_COMPILER auf „xxx“.

--gccxml-cxxflags
Setzen Sie GCCXML_CXXFLAGS auf „xxx“.

--gccxml-executable
Setzen Sie GCCXML_EXECUTABLE auf „xxx“.

--gccxml-cpp
Setzen Sie GCCXML_CPP auf „xxx“.

--gccxml-config
Setzen Sie GCCXML_CONFIG auf „xxx“.

--gccxml-root
Setzen Sie GCCXML_ROOT auf „xxx“.

--gccxml-gcc-options
GCC-Optionen aus der Datei „xxx“ lesen. Diese Option gibt eine Datei an, aus der gelesen werden soll
Optionen zur Übergabe an den gepatchten GCC C++-Parser. Dies ist nützlich, um a anzugeben
lange Liste von Include-Verzeichnissen. Jede Zeile in der Datei wird zu einer Option. Leer
Zeilen und Zeilen, die mit „#“ beginnen, werden ignoriert.

--help Vollständige Hilfe ausdrucken und beenden. In der vollständigen Hilfe wird der Großteil der von bereitgestellten Dokumentation angezeigt
die UNIX-Manpage. Es ist für die Verwendung auf Nicht-UNIX-Plattformen vorgesehen, ist es aber auch
Praktisch, wenn die Manpage nicht installiert ist.

--help-html
Vollständige Hilfe im HTML-Format drucken. Diese Option wird von GCC-XML-Autoren als Hilfe verwendet
Webseiten erstellen.

--Mann Drucken Sie eine UNIX-Manpage und beenden Sie den Vorgang. Diese Option wird von GCC-XML-Autoren zum Generieren verwendet
die UNIX-Manpage.

--drucken
Konfigurationseinstellungen drucken und beenden. GCC-XML bietet viele Konfigurationsoptionen
Helfen Sie dabei, einen anderen Compiler zu simulieren. Die Verwendung dieser Option führt dazu, dass GCC-XML
Konfigurieren Sie sich so, als würde es die C++-Quelle analysieren, aber anhalten und drucken
Die gefundene Konfiguration. Dies ist nützlich, um die Konfiguration zu überprüfen.

--vorverarbeiten
Verarbeiten Sie die Eingabe und den Ausgang vor. GCC-XML simuliert den Proprozessor eines anderen
Compiler. Die Verwendung dieser Option führt dazu, dass GCC-XML sich selbst so konfiguriert, als ob es so wäre
Ich werde die C++-Quelle analysieren, aber nach der Vorverarbeitung anhalten. Dies ist nützlich für
Debugging-Probleme im Zusammenhang mit der Simulation des anderen Compilers.

-E Alias ​​für --preprocess.

--Version
Programmname/Versionsbanner anzeigen und beenden.

Andere Flags wie -I und -D werden an die gepatchte ausführbare GCC-C++-Parserdatei weitergegeben.

EINSTELLUNGEN

GCC-XML wurde entwickelt, um den Parser eines Compilers beim Lesen von C++-Quellcode zu simulieren. Manche
Konfigurationseinstellungen sind erforderlich, um zu bestimmen, wie ein bestimmter Compiler simuliert werden soll
die Wahl des Benutzers. Die folgenden Einstellungen können zur Konfiguration von GCC-XML verwendet werden:

GCCXML_COMPILER
Der zu simulierende C++-Compiler. GCC-XML versucht, dies automatisch zu ermitteln
wie der durch diese Einstellung angegebene Compiler simuliert wird. Der Compiler ist angegeben
durch seinen ausführbaren Namen (z. B. „g++“). Für Visual Studio ist der Compiler
angegeben durch „msvc6“, „msvc7“, „msvc71“ oder „msvc8“ (wenn „cl“ angegeben ist, GCC-XML
versucht zu erraten, welches VS verwendet werden soll).

GCCXML_CXXFLAGS
Die Flags für den zu simulierenden C++-Compiler. Das Verhalten der meisten Compiler kann
durch Angabe von Flags in der Befehlszeile angepasst werden. Wenn GCC-XML dies versucht
Um automatisch zu bestimmen, wie ein Compiler simuliert wird, werden diese Flags berücksichtigt
Überlegung.

GCCXML_CONFIG
Die Konfigurationsdatei für allgemeine Einstellungen. Bei nicht standardmäßigen Einstellungen handelt es sich häufig um
Wenn Sie sie verwenden, ist es praktisch, eine einzige Datei zu schreiben, die sie enthält. Wenn eine solche Datei ist
angegeben, wird es gelesen, um alle noch nicht bekannten Einstellungen zu konfigurieren. Jede
Zeile der Datei besteht aus einer Zuweisung der Form KEY="VALUE" (z. B.
GCCXML_COMPILER="g++").

GCCXML_EXECUTABLE
Geben Sie die gepatchte ausführbare GCC C++-Parserdatei an. Das GCC-XML-Programm aus Sicht des
Der Benutzer ist eigentlich ein Frontend, das die zum Konfigurieren des Benutzers erforderlichen Flags bestimmt
GCC C++-Parser gepatcht, um einen anderen Compiler zu simulieren. Diese Einstellung legt die fest
echte ausführbare Datei, die ausgeführt werden soll, sobald die Flags bestimmt wurden. Benutzer sollten selten
Sie müssen diesen Wert von seinem Standardwert ändern.

GCCXML_CPP
Geben Sie die ausführbare GCC C-Präprozessordatei an. Das GCC-XML-Programm aus Sicht des Benutzers
ist eigentlich ein Front-End, das die Flags bestimmt, die zum Konfigurieren des Patches erforderlich sind
GCC C++-Parser zur Simulation eines anderen Compilers. Diese Einstellung legt die fest
Präprozessor zur Ausführung mit den Flags, die für das Debuggen festgelegt wurden
Zwecke. Benutzer sollten diesen Standardwert in seltenen Fällen ändern müssen.

GCCXML_ROOT
Das Verzeichnis der GCC-XML-Unterstützungsbibliothek. Da GCC-XML nur ein C++-Parser ist, ist es
kann die Funktionalität jedes Compilers, den es zu simulieren versucht, nicht genau duplizieren.
Einige Compiler stellen Standardheader mit Code bereit, den GCC-XML nicht direkt verarbeiten kann
handhaben. Um diese Einschränkung zu umgehen, wird für jeden eine Support-Bibliothek bereitgestellt
Compiler. Dies besteht aus einer Reihe von Header-Dateien, die anstelle von verwendet werden
Systemheader des Compilers. Diese Dateien enthalten geringfügige Änderungen und enthalten dann die
entsprechenden echten Header. Der Stamm des Verzeichnisbaums, der diese Unterstützung enthält
Die Anzahl der Bibliotheksheader wird durch diese Einstellung angegeben. Benutzer sollten selten Änderungen vornehmen müssen
diesen Wert vom Standardwert ab.

GCCXML_FLAGS
Flags, die zur Simulation des anderen Compilers verwendet werden. Wenn GCC-XML das gepatchte GCC C++ ausführt
Parser werden diese Flags an das Programm übergeben, um ihm mitzuteilen, wie ein simuliert werden soll
bestimmten Compiler. Diese Einstellung wird normalerweise automatisch von der anderen erkannt
Diese Einstellungen können jedoch von fortgeschrittenen Benutzern direkt festgelegt werden. Die meisten Benutzer sollten das tun
Versuchen Sie nicht, diesen Wert in der automatischen Konfiguration zu ändern.

GCCXML_USER_FLAGS
Zusätzliche Benutzerflags für die Compiler-Simulation. Wenn GCC-XML das gepatchte GCC ausführt
C++-Parser, diese Flags werden zusätzlich zu den durch GCCXML_FLAGS angegebenen Flags übergeben.
Dadurch können fortgeschrittene Benutzer die Compiler-Simulation optimieren, während sie weiterhin verwenden
automatische Konfiguration von GCCXML_FLAGS. Benutzer sollten dies selten ändern müssen
Wert von seinem Standardwert.

Es gibt verschiedene Möglichkeiten, diese Einstellungen zu konfigurieren. Sie sind hier aufgeführt
Rangfolge (höchste zuerst):

Befehlszeile Optionen
Einstellungen können durch die entsprechenden Optionen angegeben werden. Wenn eine Einstellung
Wenn die entsprechende Befehlszeilenoption bereitgestellt wird, wird sie allen anderen vorgezogen
Mittel zur Konfiguration. Wenn GCCXML_CONFIG in der Befehlszeile festgelegt ist, sind die Einstellungen gültig
Lesen Sie aus der Datei mit einer nur geringfügig niedrigeren Priorität als bei anderen Befehlszeilen
Optionen.

Arbeitsumfeld Variablen
Einstellungen werden namentlich in der Umgebung konfiguriert. Jede Einstellung ist noch nicht bekannt
wird aus einer Umgebungsvariablen mit ihrem Namen gelesen. Wenn GCCXML_CONFIG vom festgelegt wird
Umgebung werden die Einstellungen mit etwas geringerer Priorität aus der Datei gelesen
als andere Umgebungsvariablen.

Konfiguration Mappen
Es wird eine Suche nach GCCXML_CONFIG durchgeführt. Wenn GCCXML_CONFIG noch nicht festgelegt wurde, wird ein
Es wird versucht, automatisch eine Konfigurationsdatei zu finden. Erstens, wenn die Datei
$HOME/.gccxml/config vorhanden ist, wird es verwendet. Zweitens, wenn GCC-XML ausgeführt wird
aus seinem Build-Verzeichnis wird eine Konfigurationsdatei aus diesem Verzeichnis verwendet. Endlich,
Wenn eine Konfigurationsdatei im Support-Bibliotheksverzeichnis der Installation gefunden wird, wird dies der Fall sein
verwendet werden. Sobald sie gefunden wurden, werden alle unbekannten Einstellungen aus der Konfigurationsdatei gelesen.

Raten
Schätzungen basieren auf anderen Einstellungen. Sobald GCCXML_COMPILER festgelegt wurde, ist dies der Fall
Wird verwendet, um die Einstellung für GCCXML_FLAGS automatisch zu finden. Wenn es nicht festgelegt ist, wird die
Als letzten Ausweg wird die Umgebungsvariable „CXX“ überprüft, um die Compiler-Einstellung zu finden
und GCCXML_FLAGS bestimmen.

Die meisten Benutzer sollten die Standardeinstellungen für diese Einstellungen nicht anpassen müssen. Es gibt eine Standardeinstellung
GCCXML_CONFIG-Datei, die nach der Installation im Support-Bibliotheksverzeichnis bereitgestellt wird. Es
konfiguriert GCC-XML so, dass es den Compiler simuliert, der zum Erstellen verwendet wurde.

COMPILER

GCC-XML kann jeden der folgenden Compiler simulieren:

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

visuell C + +
Versionen 8, 7.1, 7.0 und 6 (sp5)

Borland, Intel, SGI
Früher unterstützt, aber nicht mehr getestet

Die folgenden zusätzlichen C-Präprozessordefinitionen werden bereitgestellt:

-D__GCCXML__=MMmmpp
MM, mm und pp sind die Haupt-, Neben- und Patchversionen von GCC-XML. Das
Das Präprozessorsymbol identifiziert GCC-XML gegenüber dem Quellcode, während dieser vorverarbeitet wird.
Es kann verwendet werden, um GCC-XML-spezifische Informationen zu aktivieren.

-D__GCCXML_GNUC__=M
Definiert für die Hauptversion des internen GCC-Parsers.

-D__GCCXML_GNUC_MINOR__=m
Definiert für die interne Nebenversion des GCC-Parsers.

-D__GCCXML_GNUC_PATCHLEVEL__=p
Definiert für den internen GCC-Parser-Patchlevel.

Fortgeschrittene Benutzer können andere Compiler simulieren, indem sie die GCCXML_FLAGS manuell konfigurieren
Einstellung. Wenden Sie sich an die Mailingliste, um Hilfe zu erhalten.

METAINFO

GCC-XML hat dem zulässigen Satz von C/C++-Attributen ein neues Attribut hinzugefügt. Das Attribut ist
Wird verwendet, um Metainformationen an den C/C++-Quellcode anzuhängen, die dann im XML angezeigt werden
Ausgang. Die Syntax zum Deklarieren eines Attributs lautet wie folgt:

__attribute((gccxml( , , ...)))
Hier ist eine Zeichenfolge in Anführungszeichen. Es muss mindestens ein Argument dafür vorhanden sein
'gccxml'-Attribut, es gibt jedoch keine Obergrenze für die Gesamtzahl der Argumente.
Es wird überprüft, dass es sich bei jedem Argument um eine Zeichenfolge handelt. Wenn ein Argument gefunden wird, das keine Zeichenfolge ist, wird die
Attribut wird ignoriert.

Die XML-Ausgabe für das Codeelement, das mit dem Attribut getaggt ist, enthält dann
die folgende:

Attribute=" ... gccxml( , , ...) ...
Das XML-Attribut „attributes“ enthält alle auf das Codeelement angewendeten Attribute.
Jedes Argument des Attributs wird ohne Anführungszeichen ausgegeben. Wenn also ein
Wenn das Argument das Zeichen „,“ enthält, erscheint das Argument als mehrfach
Argumente.

Das Attribut „gccxml“ kann auf jede Deklaration angewendet werden, einschließlich Strukturen, Klassen,
Felder, Parameter, Methoden, Funktionen, Variablen und Typdefinitionen. Die einzige Ausnahme ist
dass die Verarbeitung des Sprachelements „__attribute“ durch GCC derzeit fehlerhaft ist
Aufzählungen und Konstruktoren mit einem Inline-Körper. Das Attribut „gccxml“ kann verwendet werden
beliebig oft für eine bestimmte Deklaration.

Dies ist ein Beispiel dafür, wie dieses Attribut zum Anhängen von Metainformationen an C++ verwendet werden kann
Beachten Sie für Deklarationen das folgende Makro:

#define _aus_ __attribute((gccxml("out")))
Hier wurde „_out_“ als das gccxml-Attribut definiert, in dem sich das erste Argument befindet
ist die Zeichenfolge „out“. Es wird empfohlen, das erste Argument eindeutig zu verwenden
Stringname für den Typ der angewendeten Metainformationen.

Nun kann eine Methodendeklaration wie folgt geschrieben werden:

ungültig getInteger(_out_ int& ich);
Dadurch enthält die XML-Ausgabe Metainformationen für „_out_“.
Attribut in der Form „gccxml(out)“.

Durch die Verwendung des Attributs „gccxml“ können Metainformationen direkt in C++ eingebunden werden
Quellcode, ohne dass ein benutzerdefinierter Parser zum Extrahieren der Metainformationen erforderlich ist. Der
Das Attribut „gccxml“ wird nur zur Vereinfachung bereitgestellt – es gibt keine Garantie dafür, dass dies auch in Zukunft der Fall ist
Versionen von GCC akzeptieren das Sprachelement „__attribute“ fehlerfrei.

COPYRIGHT

GCC-XML – XML-Ausgabe für GCC

Copyright 2002-2012 Kitware, Inc., Insight Consortium

Umverteilung und Verwendung in Quell- und Binärform, mit oder ohne Modifikation, sind
zulässig, sofern folgende Bedingungen erfüllt sind:

* Bei Neuverteilungen des Quellcodes muss der obige Urheberrechtshinweis, diese Liste von
Bedingungen und den folgenden Haftungsausschluss.

* Weiterverbreitungen in binärer Form müssen den oben genannten Copyright-Hinweis und diese Liste wiedergeben
der Bedingungen und des folgenden Haftungsausschlusses in der Dokumentation und/oder anderen
Materialien, die mit der Verteilung bereitgestellt werden.

* Weder die Namen von Kitware, Inc., dem Insight Software Consortium, noch die Namen
ihrer Mitwirkenden können dazu verwendet werden, daraus abgeleitete Produkte zu unterstützen oder zu bewerben
Software ohne ausdrückliche vorherige schriftliche Genehmigung.

DIESE SOFTWARE WIRD VON DEN URHEBERRECHTSINHABERN UND MITARBEITERN „WIE BESEHEN“ UND JEGLICH ZUR VERFÜGUNG GESTELLT
AUSDRÜCKLICHE ODER STILLSCHWEIGENDE GEWÄHRLEISTUNGEN, EINSCHLIESSLICH, ABER NICHT BESCHRÄNKT AUF DIE STILLSCHWEIGENDEN GEWÄHRLEISTUNGEN VON
MARKTGÄNGIGKEIT UND EIGNUNG FÜR EINEN BESTIMMTEN ZWECK WERDEN AUSGESCHLOSSEN. IN KEINEM FALL DÜRFEN DIE
URHEBERRECHTSINHABER ODER MITARBEITER HAFTEN FÜR JEGLICHE DIREKTE, INDIREKTE, ZUFÄLLIGE, SPEZIELLE
BEISPIELHAFTE SCHÄDEN ODER FOLGESCHÄDEN (EINSCHLIESSLICH, ABER NICHT BESCHRÄNKT AUF DIE BESCHAFFUNG VON
WAREN ODER DIENSTLEISTUNGEN ERSETZEN; NUTZUNGS-, DATEN- ODER GEWINNVERLUST; ODER GESCHÄFTSUNTERBRECHUNG)
Unabhängig von der Ursache und jedweder Haftungstheorie, sei es vertraglich, verschuldensunabhängig oder
(EINSCHLIESSLICH FAHRLÄSSIGKEIT ODER ANDERWEITIG), DIE SICH AUS DER VERWENDUNG DIESES ERGEBEN
SOFTWARE, AUCH WENN AUF DIE MÖGLICHKEIT DIESER SCHÄDEN hingewiesen wird.

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

gccxml_cc1plus – Ein GCC-Parser, der für XML-Dumps von Übersetzungseinheiten gepatcht wurde

Copyright 2002-2012 Kitware, Inc., Insight Consortium

Dieses Programm ist freie Software; Sie können es unter den Bedingungen von . weitergeben und/oder ändern
die GNU General Public License, wie von der Free Software Foundation veröffentlicht; entweder
Version 2 der Lizenz oder (nach Ihrer Wahl) eine spätere Version.

Dieses Programm wird in der Hoffnung verteilt, dass es nützlich ist, jedoch OHNE JEGLICHE GEWÄHRLEISTUNG;
auch ohne die stillschweigende Garantie der MARKTFÄHIGKEIT oder EIGNUNG FÜR EINEN BESTIMMTEN ZWECK.
Weitere Informationen finden Sie in der GNU General Public License.

Zusammen mit diesem Programm sollten Sie eine Kopie der GNU General Public License erhalten haben;
Wenn nicht, schreiben Sie an die
Free Software Foundation, Inc.
51 Franklin Street, fünfter Stock
Boston, MA 02110-1301 USA

POST LISTE

Für Hilfe und Diskussionen zur Verwendung von gccxml steht eine Mailingliste unter zur Verfügung
[E-Mail geschützt] . Bitte lesen Sie zunächst die vollständige Dokumentation unter http://www.gccxml.org
bevor Sie Fragen an die Liste senden.

Verwenden Sie gccxml online über die Dienste von onworks.net