gccxml - Online nel cloud

PROGRAMMA:

NOME

gccxml - Creare una rappresentazione XML delle dichiarazioni C++.

SINOSSI

gccxml [opzioni] -fxml=

DESCRIZIONE

GCC-XML analizza un file sorgente C++ come viene visto dal compilatore quando viene compilato. Un facile-
la rappresentazione XML da analizzare delle dichiarazioni di classe, funzione e spazio dei nomi viene scaricata
a un file specificato. La pre-elaborazione C completa trasforma il file in un'unità di traduzione C++
come visto dal compilatore. Ciò significa che GCC-XML dovrebbe utilizzare lo stesso standard
libreria e altri file di intestazione come compilatore. GCC-XML può essere configurato per simulare qualsiasi
di molti popolari compilatori.

VERSIONI

Le seguenti opzioni sono disponibili per l'esecuzione di GCC-XML:

--diritto d'autore
Stampa il copyright GCC-XML ed esci.

- debug
Stampa ulteriori informazioni di debug. Questa opzione fa in modo che GCC-XML stampi il
nome dell'eseguibile e argomenti della riga di comando utilizzati per eseguire il GCC C++ con patch
analizzatore. Ciò è utile quando si tenta di simulare un compilatore non supportato.

-fxml=
Specificare il file di output XML. Questa opzione viene passata direttamente al GCC con patch
Analizzatore C++. Abilita il dump XML e specifica il nome del file di output.

-fxml-start= [,...]
Specificare un elenco di dichiarazioni iniziali. Questa opzione viene passata direttamente al
parser GCC C++ con patch. È significativo solo se è specificato anche -fxml=. Questo
specifica un elenco separato da virgole di dichiarazioni iniziali denominate. GCC-XML eseguirà il dump
solo il sottoinsieme delle dichiarazioni nell'unità di traduzione che è raggiungibile
attraverso una sequenza di riferimenti alla fonte da uno degli iniziali specificati
dichiarazioni.

--gccxml-compilatore
Imposta GCCXML_COMPILER su "xxx".

--gccxml-cxxflags
Imposta GCCXML_CXXFLAGS su "xxx".

--gccxml-eseguibile
Imposta GCCXML_EXECUTABLE su "xxx".

--gccxml-cpp
Imposta GCCXML_CPP su "xxx".

--gccxml-config
Imposta GCCXML_CONFIG su "xxx".

--gccxml-root
Imposta GCCXML_ROOT su "xxx".

--gccxml-gcc-opzioni
Leggi le opzioni GCC dal file "xxx". Questa opzione specifica un file da cui leggere
opzioni da passare al parser GCC C++ con patch. Questo è utile per specificare a
lungo elenco di directory di inclusione. Ogni riga nel file diventa un'opzione. Vuoto
le righe e le righe che iniziano con '#' vengono ignorate.

--Aiuto Stampa la guida completa ed esci. La guida completa mostra la maggior parte della documentazione fornita da
la pagina man di UNIX. Viene fornito per l'uso su piattaforme non UNIX, ma è anche
conveniente se la pagina man non è installata.

--help-html
Stampa la guida completa in formato HTML. Questa opzione è usata dagli autori GCC-XML per aiutare
produrre pagine web.

--uomo Stampa una pagina man UNIX ed esci. Questa opzione è usata dagli autori GCC-XML per generare
la pagina man di UNIX.

--Stampa
Stampa le impostazioni di configurazione ed esci. GCC-XML ha molte opzioni di configurazione per
aiutalo a simulare un altro compilatore. L'utilizzo di questa opzione farà sì che GCC-XML
configura se stesso come se stesse per analizzare il sorgente C++, ma fermati e stampa
la configurazione trovata. Questo è utile per controllare la configurazione.

--preprocesso
Preelabora l'input e l'uscita. GCC-XML simula il proprocessore di un altro
compilatore. L'uso di questa opzione farà sì che GCC-XML si configuri come se lo fosse
andando ad analizzare il sorgente C++, ma si ferma dopo la preelaborazione. Questo è utile per
problemi di debugging relativi alla simulazione dell'altro compilatore.

-E Alias ​​per --preprocess.

--versione
Mostra il nome del programma/il banner della versione ed esci.

Altri flag, come -I e -D, vengono passati all'eseguibile del parser C++ GCC con patch.

IMPOSTAZIONI

GCC-XML è progettato per simulare il parser di un compilatore durante la lettura del codice sorgente C++. Alcuni
le impostazioni di configurazione sono necessarie per determinare come simulare un particolare compilatore di
la scelta dell'utente. Le seguenti impostazioni possono essere utilizzate per configurare GCC-XML:

GCCXML_COMPILER
Il compilatore C++ da simulare. GCC-XML tenterà di determinare automaticamente
come simulare il compilatore specificato da questa impostazione. Il compilatore è specificato
dal nome dell'eseguibile (come "g++"). Per Visual Studio, il compilatore è
specificato da "msvc6", "msvc7", "msvc71" o "msvc8" (se viene fornito "cl", GCC-XML
tenta di indovinare quale VS usare).

GCCXML_CXXFLAGS
I flag per il compilatore C++ da simulare. Il comportamento della maggior parte dei compilatori può
essere regolato specificando i flag sulla riga di comando. Quando GCC-XML tenta di
determinare automaticamente come simulare un compilatore, questi flag vengono presi in considerazione
considerazione.

GCCXML_CONFIG
Il file di configurazione per le impostazioni comuni. Quando le impostazioni non predefinite sono spesso
utilizzati, è conveniente scrivere un unico file che li contenga. Quando un file del genere è
specificato, verrà letto per configurare eventuali impostazioni non ancora note. Ogni
la riga del file è costituita da un'assegnazione della forma KEY="VALUE" (ad esempio,
GCCXML_COMPILER="g++").

GCCXML_EXECABLE
Specificare l'eseguibile del parser C++ GCC con patch. Il programma GCC-XML visto dal
user è in realtà un front-end che determina i flag necessari per configurare il
parser GCC C++ con patch per simulare un altro compilatore. Questa impostazione specifica il
eseguibile reale da eseguire una volta determinati i flag. Gli utenti dovrebbero raramente
è necessario modificare questo valore dal suo valore predefinito.

GCCXML_CPP
Specificare l'eseguibile del preprocessore GCC C. Il programma GCC-XML visto dall'utente
è in realtà un front-end che determina i flag necessari per configurare il patchato
GCC C++ parser per simulare un altro compilatore. Questa impostazione specifica il
preprocessore da eseguire con i flag che sono stati determinati per il debug
scopi. Gli utenti dovrebbero raramente aver bisogno di modificare questo valore rispetto al valore predefinito.

GCCXML_ROOT
La directory della libreria di supporto GCC-XML. Poiché GCC-XML è solo un parser C++, è
non può duplicare esattamente la funzionalità di ogni compilatore che tenta di simulare.
Alcuni compilatori forniscono intestazioni standard con codice che GCC-XML non può direttamente
maneggiare. Per aggirare questa limitazione, viene fornita una libreria di supporto per ciascuno
compilatore. Consiste in un insieme di file di intestazione che vengono utilizzati al posto di
intestazioni di sistema del compilatore. Questi file contengono lievi modifiche e quindi includono il
corrispondente intestazione reale. La radice dell'albero delle directory che contiene questi supporti
le intestazioni della libreria sono specificate da questa impostazione. Gli utenti dovrebbero raramente aver bisogno di cambiare
questo valore dal suo valore predefinito.

GCCXML_FLAGS
Flag usati per simulare l'altro compilatore. Quando GCC-XML esegue il GCC C++ con patch
parser, questi flag vengono passati al programma per dirgli come simulare a
compilatore particolare. Questa impostazione viene solitamente rilevata automaticamente dall'altra
impostazioni, ma può essere specificato direttamente dagli utenti avanzati. La maggior parte degli utenti dovrebbe
non tentare di modificare questo valore dalla configurazione automatica.

GCCXML_USER_FLAGS
Flag utente aggiuntivi per la simulazione del compilatore. Quando GCC-XML esegue il GCC con patch
C++ parser, questi flag vengono passati in aggiunta a quelli specificati da GCCXML_FLAGS.
Ciò consente agli utenti avanzati di modificare la simulazione del compilatore mentre continuano a utilizzare il
configurazione automatica di GCCXML_FLAGS. Gli utenti dovrebbero raramente aver bisogno di cambiarlo
valore dal suo valore predefinito.

Esistono diversi modi per configurare queste impostazioni. Sono elencati qui in
ordine di precedenza (prima il più alto):

Riga di comando Opzioni
Le impostazioni possono essere specificate dalle opzioni corrispondenti. Quando un'impostazione è
viene fornita l'opzione della riga di comando corrispondente, viene utilizzata a favore di qualsiasi altra
mezzo di configurazione. Se GCCXML_CONFIG è impostato sulla riga di comando, le impostazioni sono
letto dal file con precedenza appena leggermente inferiore rispetto ad altre righe di comando
opzioni.

Ambiente Variabili
Le impostazioni sono configurate per nome nell'ambiente. Ogni impostazione non è già nota
viene letto da una variabile d'ambiente con il suo nome. Se GCCXML_CONFIG è impostato da
ambiente, le impostazioni vengono lette dal file con precedenza appena leggermente inferiore
rispetto ad altre variabili d'ambiente.

Configurazione File
Viene eseguita una ricerca per GCCXML_CONFIG. Se GCCXML_CONFIG non è stato ancora impostato, un
si tenta di trovare automaticamente un file di configurazione. Innanzitutto, se il file
$HOME/.gccxml/config esiste, verrà utilizzato. Secondo, se GCC-XML è in esecuzione
dalla sua directory di compilazione, verrà utilizzato un file di configurazione da quella directory. Finalmente,
se viene trovato un file di configurazione nella directory della libreria di supporto dell'installazione, lo farà
essere usato. Una volta trovate, tutte le impostazioni sconosciute vengono lette dal file di configurazione.

indovinare
Le ipotesi sono fatte sulla base di altre impostazioni. Una volta che GCCXML_COMPILER è stato impostato, è
utilizzato per trovare automaticamente l'impostazione per GCCXML_FLAGS. Se non è impostato, il
La variabile di ambiente "CXX" viene controllata come ultima risorsa per trovare l'impostazione del compilatore
e determinare GCCXML_FLAGS.

La maggior parte degli utenti non dovrebbe dover regolare le impostazioni predefinite per queste impostazioni. C'è un'impostazione predefinita
File GCCXML_CONFIG fornito nella directory della libreria di supporto dopo l'installazione. Esso
configura GCC-XML per simulare il compilatore utilizzato per compilarlo.

COMPILATORI

GCC-XML può simulare uno dei seguenti compilatori:

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

Visivo C++
Versioni 8, 7.1, 7.0 e 6 (sp5)

Borland Intel, SGI
precedentemente supportato ma non più testato

Sono fornite le seguenti definizioni extra del preprocessore C:

-D__GCCXML__=MMmmpp
MM, mm e pp sono le versioni principali, secondarie e patch di GCC-XML. Questo
il simbolo del preprocessore identifica GCC-XML nel codice sorgente mentre viene preelaborato.
Può essere utilizzato per abilitare le informazioni specifiche di GCC-XML.

-D__GCCXML_GNUC__=M
Definito per la versione principale del parser GCC interno.

-D__GCCXML_GNUC_MINOR__=m
Definito per la versione secondaria del parser GCC interno.

-D__GCCXML_GNUC_PATCHLEVEL__=pag
Definito a livello di patch del parser GCC interno.

Gli utenti avanzati possono simulare altri compilatori configurando manualmente GCCXML_FLAGS
collocamento. Contatta la mailing list per assistenza.

METAINFO

GCC-XML ha aggiunto un nuovo attributo al set legale di attributi C/C++. L'attributo è
usato per allegare metainformazioni al codice sorgente C/C++, che apparirà poi nell'XML
produzione. La sintassi per dichiarare un attributo è la seguente:

__attributo((gccxml( , , ...)))
Qui è una stringa quotata. Ci deve essere almeno un argomento per il
'gccxml', ma non esiste un limite superiore al numero totale di argomenti.
Ogni argomento è verificato per essere una stringa - se viene trovato un argomento non stringa, il
l'attributo viene ignorato.

L'output XML per l'elemento di codice che è taggato con l'attributo conterrà quindi
il seguente:

attributi=" ... gccxml( , , ...) ...
L'attributo XML 'attributes' contiene tutti gli attributi applicati all'elemento di codice.
Ogni argomento dell'attributo viene stampato senza racchiudere le virgolette, quindi se an
argomento contiene il carattere ',', l'argomento apparirà multiplo
argomenti.

L'attributo 'gccxml' può essere applicato a qualsiasi dichiarazione inclusi struct, classi,
campi, parametri, metodi, funzioni, variabili e typedef. L'unica eccezione è
che la gestione dell'elemento linguistico '__attribute' da parte di GCC è attualmente interrotta per
enumerazioni e costruttori con un corpo inline. È possibile utilizzare l'attributo 'gccxml'
un numero qualsiasi di volte su una data dichiarazione.

Come esempio di come questo attributo può essere utilizzato per allegare metainformazioni a C++
dichiarazioni, si consideri la seguente macro:

#define _fuori_ __attribute((gccxml("out")))
Qui '_out_' è stato definito come l'attributo gccxml dove il primo argomento
è la stringa "fuori". Si consiglia di utilizzare il primo argomento come univoco
nome stringa per il tipo di meta-informazioni che iniziano ad essere applicate.

Ora una dichiarazione di metodo può essere scritta come segue:

nulla getInteger(_out_ int& io);
Ciò farà sì che l'output XML contenga meta informazioni per '_out_'
attributo, nella forma "gccxml(out)".

L'utilizzo dell'attributo 'gccxml' consente di includere le meta informazioni direttamente all'interno di C++
codice sorgente, senza la necessità di un parser personalizzato per estrarre le meta informazioni. Il
L'attributo 'gccxml' è fornito solo per comodità - non vi è alcuna garanzia che il futuro
le versioni di GCC accetteranno l'elemento linguistico '__attribute' in modo esente da bug.

COPYRIGHT

GCC-XML - Output XML per GCC

Copyright 2002-2012 Kitware, Inc., Consorzio Insight

La ridistribuzione e l'uso in forma sorgente e binaria, con o senza modifiche, sono
consentito a condizione che siano soddisfatte le seguenti condizioni:

* Le ridistribuzioni del codice sorgente devono mantenere l'avviso di copyright di cui sopra, questo elenco di
condizioni e il seguente disclaimer.

* Le ridistribuzioni in forma binaria devono riprodurre l'avviso di copyright di cui sopra, questo elenco
delle condizioni e la seguente esclusione di responsabilità nella documentazione e/o altro
materiali forniti con la distribuzione.

* Né i nomi di Kitware, Inc., Insight Software Consortium, né i nomi
dei loro contributori possono essere utilizzati per avallare o promuovere prodotti derivati ​​da questo
software senza previa autorizzazione scritta.

QUESTO SOFTWARE È FORNITO DAI TITOLARI DEL COPYRIGHT E DAI COLLABORATORI "COS COM'È" E QUALSIASI
GARANZIE ESPRESSE O IMPLICITE, COMPRESE, MA NON LIMITATE A, LE GARANZIE IMPLICITE DI
LA COMMERCIABILITÀ E L'IDONEITÀ PER UNO SCOPO PARTICOLARE SONO ESCLUSI. IN NESSUN CASO IL
IL TITOLARE DEL COPYRIGHT O I COLLABORATORI SARANNO RESPONSABILI PER QUALSIASI DIRETTO, INDIRETTO, ACCIDENTALE, SPECIALE,
DANNI ESEMPLARI O CONSEQUENZIALI (INCLUSI, MA NON LIMITATI A, APPROVVIGIONAMENTO DI
BENI O SERVIZI SOSTITUTIVI; PERDITA DI UTILIZZO, DATI O PROFITTI; O INTERRUZIONE DI ATTIVITÀ)
TUTTAVIA CAUSATA E SU QUALSIASI TEORIA DI RESPONSABILITÀ, SIA IN CONTRATTO, RESPONSABILITÀ RIGOROSA, O
ILLECITO (INCLUSA LA NEGLIGENZA O ALTRO) DERIVANTE IN QUALSIASI MODO DALL'USO DI QUESTO
SOFTWARE, ANCHE SE AVVISATA DELLA POSSIBILITÀ DI TALI DANNI.

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

gccxml_cc1plus - Un parser GCC patchato per dump XML di unità di traduzione

Copyright 2002-2012 Kitware, Inc., Consorzio Insight

Questo programma è un software gratuito; puoi ridistribuirlo e/o modificarlo secondo i termini di
la GNU General Public License come pubblicata dalla Free Software Foundation; o
versione 2 della Licenza o (a tua scelta) qualsiasi versione successiva.

Questo programma è distribuito nella speranza che possa essere utile, ma SENZA ALCUNA GARANZIA;
senza nemmeno la garanzia implicita di COMMERCIABILITÀ o IDONEITÀ PER UN PARTICOLARE SCOPO.
Vedere la GNU General Public License per maggiori dettagli.

Dovresti aver ricevuto una copia della GNU General Public License insieme a questo programma;
se no, scrivi a
Free Software Foundation, Inc.
51 Franklin Street, quinto piano
Boston, MA 02110-1301 Stati Uniti

MAILING ELENCO

Per assistenza e discussione sull'utilizzo di gccxml, è disponibile una mailing list all'indirizzo
[email protected]. Si prega di leggere prima la documentazione completa su http://www.gccxml.org
prima di inviare domande alla lista.

Usa gccxml online utilizzando i servizi onworks.net