gccxml - Online în cloud

PROGRAM:

NUME

gccxml - Creați o reprezentare XML a declarațiilor C++.

REZUMAT

gccxml [opțiuni] -fxml=

DESCRIERE

GCC-XML analizează un fișier sursă C++ așa cum este văzut de compilator atunci când este construit. Un ușor-
Reprezentarea XML to-parse a declarațiilor de clasă, funcție și spațiu de nume este eliminată
la un fișier specificat. Preprocesarea completă C transformă fișierul într-o unitate de traducere C++
după cum se vede de compilator. Aceasta înseamnă că GCC-XML ar trebui să utilizeze același standard
bibliotecă și alte fișiere antet ca compilator. GCC-XML poate fi configurat pentru a simula orice
a mai multor compilatoare populare.

OPŢIUNI

Următoarele opțiuni sunt disponibile pentru rularea GCC-XML:

--drepturi de autor
Imprimați drepturile de autor GCC-XML și ieșiți.

--depanare
Imprimați informații suplimentare de depanare. Această opțiune face ca GCC-XML să imprime fișierul
numele executabilului și argumentele liniei de comandă utilizate pentru a executa GCC C++ corecţionat
analizator. Acest lucru este util atunci când încercați să simulați un compilator neacceptat.

-fxml=
Specificați fișierul de ieșire XML. Această opțiune este transmisă direct către GCC corecţionat
parser C++. Activează descărcarea XML și specifică numele fișierului de ieșire.

-fxml-start= [,...]
Specificați o listă de declarații de început. Această opțiune este transmisă direct către
analizator GCC C++ corectat. Are sens numai dacă este specificat și -fxml=. Acest
specifică o listă separată prin virgulă de declarații de început numite. GCC-XML va descărca
numai subsetul declarațiilor din unitatea de traducere care este accesibil
printr-o succesiune de referințe sursă de la una dintre porniile specificate
declarații.

--gccxml-compiler
Setați GCCXML_COMPILER la „xxx”.

--gccxml-cxxflags
Setați GCCXML_CXXFLAGS la „xxx”.

--gccxml-executable
Setați GCCXML_EXECUTABLE la „xxx”.

--gccxml-cpp
Setați GCCXML_CPP la „xxx”.

--gccxml-config
Setați GCCXML_CONFIG la „xxx”.

--gccxml-root
Setați GCCXML_ROOT la „xxx”.

--gccxml-gcc-options
Citiți opțiunile GCC din fișierul „xxx”. Această opțiune specifică un fișier din care să citești
opțiuni pentru a trece la parserul GCC C++ corecţionat. Acest lucru este util pentru a specifica a
listă lungă de directoare incluse. Fiecare linie din fișier devine o opțiune. Gol
liniile și liniile care încep cu „#” sunt ignorate.

--Ajutor Imprimați ajutorul complet și ieșiți. Ajutorul complet afișează cea mai mare parte a documentației furnizate de
pagina de manual UNIX. Este furnizat pentru utilizare pe platforme non-UNIX, dar este și
convenabil dacă pagina de manual nu este instalată.

--help-html
Tipăriți ajutorul complet în format HTML. Această opțiune este folosită de autorii GCC-XML pentru a ajuta
produce pagini web.

--om Imprimați o pagină de manual UNIX și ieșiți. Această opțiune este folosită de autorii GCC-XML pentru a genera
pagina de manual UNIX.

--imprimare
Imprimați setările de configurare și ieșiți. GCC-XML are multe opțiuni de configurare pentru
ajutați-l să simuleze un alt compilator. Folosind această opțiune, GCC-XML va face
se configurează ca și cum ar urma să analizeze sursa C++, dar se oprește și se imprimă
configurația găsită. Acest lucru este util pentru verificarea configurației.

--preproces
Preprocesează intrarea și ieșirea. GCC-XML simulează procesorul altuia
compilator. Utilizarea acestei opțiuni va determina GCC-XML să se configureze ca și cum ar fi
vom analiza sursa C++, dar se oprește după preprocesare. Acest lucru este util pentru
probleme de depanare legate de simularea celuilalt compilator.

-E Alias ​​pentru --preprocess.

--versiune
Afișați bannerul numelui/versiunii programului și ieșiți.

Alte steaguri, cum ar fi -I și -D, sunt transmise executabilului analizator GCC C++ patchizat.

SETTINGS

GCC-XML este conceput pentru a simula analizatorul unui compilator în timp ce citește codul sursă C++. niste
setările de configurare sunt necesare pentru a determina modul de simulare a unui anumit compilator
alegerea utilizatorului. Următoarele setări pot fi utilizate pentru a configura GCC-XML:

GCCXML_COMPILER
Compilatorul C++ de simulat. GCC-XML va încerca să determine automat
cum să simuleze compilatorul specificat de această setare. Este specificat compilatorul
după numele său executabil (cum ar fi „g++”). Pentru Visual Studio, compilatorul este
specificat de „msvc6”, „msvc7”, „msvc71” sau „msvc8” (dacă este dat „cl”, GCC-XML
încearcă să ghicească ce VS să folosească).

GCCXML_CXXFLAGS
Indicatorii pentru compilatorul C++ să fie simulate. Comportamentul majorității compilatorilor poate
fi ajustat prin specificarea steagurilor pe linia de comandă. Când GCC-XML încearcă
determină automat cum să simuleze un compilator, aceste steaguri sunt luate în considerare
considerare.

GCCXML_CONFIG
Fișierul de configurare pentru setările comune. Când setările care nu sunt implicite sunt adesea
utilizate, este convenabil să scrieți un singur fișier care le conține. Când un astfel de fișier este
specificat, va fi citit pentru a configura orice setări care nu sunt încă cunoscute. Fiecare
linia fișierului constă dintr-o atribuire de forma KEY="VALUE" (de exemplu,
GCCXML_COMPILER="g++").

GCCXML_EXECUTABLE
Specificați executabilul analizator GCC C++ corectat. Programul GCC-XML, așa cum este văzut de
utilizatorul este de fapt un front-end care determină steagurile necesare pentru a configura
parser-ul GCC C++ corectat pentru a simula un alt compilator. Această setare specifică
executabil real să ruleze odată ce steaguri au fost determinate. Utilizatorii ar trebui rar
trebuie să schimbați această valoare din valoarea implicită.

GCCXML_CPP
Specificați executabilul preprocesorului GCC C. Programul GCC-XML așa cum este văzut de utilizator
este de fapt un front-end care determină steagurile necesare pentru a configura patch-ul
GCC C++ parser pentru a simula un alt compilator. Această setare specifică
preprocesorul să ruleze cu steagurile care au fost determinate pentru depanare
scopuri. Utilizatorii ar trebui rareori să fie nevoiți să schimbe această valoare din valoarea implicită.

GCCXML_ROOT
Directorul bibliotecii de suport GCC-XML. Deoarece GCC-XML este un singur parser C++, acesta
nu poate duplica exact funcționalitatea fiecărui compilator pe care încearcă să-l simuleze.
Unele compilatoare furnizează antete standard cu cod pe care GCC-XML nu poate fi direct
mâner. Pentru a evita această limitare, este furnizată o bibliotecă de asistență pentru fiecare
compilator. Acesta constă dintr-un set de fișiere antet care sunt utilizate în locul fișierului
anteturile de sistem ale compilatorului. Aceste fișiere conțin ușoare modificări și apoi includ
antetul real corespunzător. Rădăcina arborelui de directoare care conține aceste suporturi
anteturile bibliotecii sunt specificate de această setare. Utilizatorii ar trebui să fie rareori nevoiți să se schimbe
această valoare din valoarea implicită.

GCCXML_FLAGS
Steaguri folosite pentru a simula celălalt compilator. Când GCC-XML rulează GCC C++ corecţionat
parser, aceste steaguri sunt transmise programului pentru a-i spune cum să simuleze a
un anumit compilator. Această setare este de obicei detectată automat de la cealaltă
setări, dar poate fi specificat direct de către utilizatorii avansați. Majoritatea utilizatorilor ar trebui
nu încercați să schimbați această valoare din configurația automată.

GCCXML_USER_FLAGS
Indicatori suplimentari de utilizator pentru simularea compilatorului. Când GCC-XML rulează GCC-ul corectat
Analizor C++, aceste steaguri sunt transmise în plus față de cele specificate de GCCXML_FLAGS.
Acest lucru permite utilizatorilor avansați să modifice simularea compilatorului în timp ce încă folosesc
configurarea automată a GCCXML_FLAGS. Utilizatorii ar trebui rareori să fie nevoiți să schimbe acest lucru
valoarea implicită.

Există mai multe mijloace prin care aceste setări sunt configurate. Ele sunt enumerate aici în
ordinea de prioritate (cel mai mare primul):

Linie de comanda Opţiuni
Setările pot fi specificate prin opțiunile corespunzătoare. Când este o setare
este furnizată opțiunea de linie de comandă corespunzătoare, este folosită în favoarea oricărei alte
mijloace de configurare. Dacă GCCXML_CONFIG este setat pe linia de comandă, setările sunt
citiți din fișier cu o prioritate puțin mai mică decât alte linie de comandă
opțiuni.

Mediu inconjurator Variabile
Setările sunt configurate după nume în mediu. Fiecare setare nu este deja cunoscută
este citit dintr-o variabilă de mediu cu numele acesteia. Dacă GCCXML_CONFIG este setat de
mediu, setările sunt citite din fișier cu o prioritate puțin mai mică
decât alte variabile de mediu.

Configuraţie Fişiere
Se efectuează o căutare pentru GCCXML_CONFIG. Dacă GCCXML_CONFIG nu a fost încă setat, un
se încearcă găsirea automată a unui fișier de configurare. În primul rând, dacă fișierul
$HOME/.gccxml/config există, va fi folosit. În al doilea rând, dacă se execută GCC-XML
din directorul său de compilare, va fi folosit un fișier de configurare din acel director. In cele din urma,
dacă se găsește un fișier de configurare în directorul bibliotecii de suport al instalării, va fi
fi folosit. Odată găsite, orice setări necunoscute sunt citite din fișierul de configurare.

ghicitul
Presupunerile sunt făcute pe baza altor setări. Odată ce GCCXML_COMPILER a fost setat, este
folosit pentru a găsi automat setarea pentru GCCXML_FLAGS. Dacă nu este setat,
Variabila de mediu „CXX” este verificată ca ultimă soluție pentru a găsi setarea compilatorului
și determinați GCCXML_FLAGS.

Majoritatea utilizatorilor nu ar trebui să ajusteze setările implicite pentru aceste setări. Există o implicită
Fișierul GCCXML_CONFIG furnizat în directorul bibliotecii de asistență după instalare. Aceasta
configurează GCC-XML să simuleze compilatorul care a fost folosit pentru al construi.

COMPILATORI

GCC-XML poate simula oricare dintre următoarele compilatoare:

CGC Versiunile 4.2, 4.1, 4.0, 3.4, 3.3, 3.2, 2.95.x

Vizual C ++
Versiunile 8, 7.1, 7.0 și 6 (sp5)

Borland, Intel, SGI
susținut anterior, dar nu mai este testat

Sunt furnizate următoarele definiții suplimentare de preprocesor C:

-D__GCCXML__=MMmmpp
MM, mm și pp sunt versiunile majore, minore și de corecție ale GCC-XML. Acest
Simbolul preprocesorului identifică GCC-XML la codul sursă, pe măsură ce acesta este preprocesat.
Poate fi folosit pentru a activa informațiile specifice GCC-XML.

-D__GCCXML_GNUC__=M
Definit pentru versiunea majoră a analizorului GCC intern.

-D__GCCXML_GNUC_MINOR__=m
Definit pentru versiunea minoră a analizorului GCC intern.

-D__GCCXML_GNUC_PATCHLEVEL__=p
Definit la nivelul de corecție al analizorului GCC intern.

Utilizatorii avansați pot simula alte compilatoare configurând manual GCCXML_FLAGS
setare. Contactați lista de corespondență pentru ajutor.

METAINFO

GCC-XML a adăugat un nou atribut la setul legal de atribute C/C++. Atributul este
folosit pentru a atașa meta informații la codul sursă C/C++, care va apărea apoi în XML
ieșire. Sintaxa pentru declararea unui atribut este următoarea:

__attribute((gccxml( , , ...)))
Aici este un șir între ghilimele. Trebuie să existe cel puțin un argument pentru
„gccxml”, dar nu există o limită superioară a numărului total de argumente.
Fiecare argument este verificat ca fiind un șir - dacă este găsit un argument care nu este șir, acesta
atributul este ignorat.

Ieșirea XML pentru elementul de cod care este etichetat cu atributul va conține apoi
următoarele:

atribute=" ... gccxml( , , ...) ...
Atributul XML „atribute” conține toate atributele aplicate elementului de cod.
Fiecare argument al atributului este tipărit fără ghilimele, deci dacă an
argumentul conține caracterul „,”, argumentul va părea a fi multiplu
argumente.

Atributul „gccxml” poate fi aplicat oricărei declarații, inclusiv structuri, clase,
câmpuri, parametri, metode, funcții, variabile și definiții de tip. Singura excepție este
pentru care gestionarea de către GCC a elementului de limbaj „__attribute” este în prezent întreruptă
enumerari si constructori cu un corp inliniat. Atributul „gccxml” poate fi utilizat
de câte ori pe o anumită declarație.

Ca exemplu despre modul în care acest atribut poate fi utilizat pentru a atașa meta informații la C++
declarații, luați în considerare următoarea macrocomandă:

#defini _out_ __attribute((gccxml("out")))
Aici „_out_” a fost definit ca fiind atributul gccxml unde primul argument
este șirul „out”. Se recomandă ca primul argument să fie folosit ca unic
numele șirului pentru tipul de metainformații începe aplicat.

Acum o declarație de metodă poate fi scrisă după cum urmează:

anula getInteger(_out_ int& i);
Acest lucru va face ca rezultatul XML să conțină meta informații pentru „_out_”
atribut, sub forma „gccxml(out)”.

Utilizarea atributului „gccxml” permite ca informațiile meta să fie incluse direct în C++
cod sursă, fără a fi nevoie de un parser personalizat pentru a extrage metainformația. The
Atributul „gccxml” este furnizat numai pentru comoditate - nu există nicio garanție că viitorul
versiunile GCC vor accepta elementul de limbaj „__attribute” fără erori.

DREPTURI DE AUTOR

GCC-XML - Ieșire XML pentru GCC

Copyright 2002-2012 Kitware, Inc., Insight Consortium

Redistribuirea și utilizarea în forme sursă și binare, cu sau fără modificare, sunt
permise cu condiția îndeplinirii următoarelor condiții:

* Redistribuirile codului sursă trebuie să păstreze notificarea de mai sus privind drepturile de autor, această listă
condițiile și următoarea declinare a răspunderii.

* Redistribuirile în formă binară trebuie să reproducă nota de copyright de mai sus, această listă
de condiții și următoarea declinare a răspunderii din documentație și/sau altele
materialele furnizate odată cu distribuția.

* Nici numele Kitware, Inc., Insight Software Consortium, nici numele
dintre contribuatorii lor pot fi folosiți pentru a susține sau promova produse derivate din aceasta
software fără permisiunea scrisă prealabilă specifică.

ACEST SOFTWARE ESTE FURNIZAT DE DEȚINĂTORII DE DREPTURI DE AUTOR ȘI DE CONTRIBUITORI „CA AȘA ESTE” ȘI DE ORICE
GARANȚII EXPRESE SAU IMPLICITE, INCLUSIV, DAR FĂRĂ A SE LIMITA LA, GARANȚIILE IMPLICITE ALE
VANTABILITATEA ȘI ADECVENȚA PENTRU UN ANUMIT SCOP SUNT RENUNCIATE. ÎN NICIO CAZ
DEȚINĂRUL DREPTURILOR DE AUTOR SAU CONTRIBUTORII RĂSPUNDE PENTRU ORICE DIRECTE, INDIRECTE, INCIDENTALE, SPECIALE,
DAUNE EXEMPLARE SAU CONSECUȚIONALE (INCLUSIV, DAR FĂRĂ A SE LIMITĂ LA, ACHIZIȚIA DE
BUNURI SAU SERVICII DE SUBSTITUT; PIERDERE DE UTILIZARE, DATE SAU PROFIT; SAU ÎNTRERUPEREA AFACERII)
Oricum ar fi cauzat și pe baza ORICE TEORIE A RĂSPUNDERII, FIEA ÎN CONTRACT, RĂSPUNDERE STRICT, SAU
DELICITĂȚI (INCLUSIVELE NEGLIGENȚEI SAU ALTE MODE) DECORITE ÎN ORICE MOD DE UTILIZARE A ACESTEI
SOFTWARE, CHIAR DACĂ ESTE AVIZAT DE POSIBILITATEA ASEMÂNĂRILOR.

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

gccxml_cc1plus - Un parser GCC corecţionat pentru depozitele XML ale unităţilor de traducere

Copyright 2002-2012 Kitware, Inc., Insight Consortium

Acest program este software gratuit; îl puteți redistribui și/sau modifica în conformitate cu termenii
Licența publică generală GNU publicată de Free Software Foundation; fie
versiunea 2 a Licenței sau (la alegerea dvs.) orice versiune ulterioară.

Acest program este distribuit in speranta ca va fi de folos, dar FARA NICIO GARANTIE;
fără nici măcar garanția implicită de VANTABILITATE sau ADECVARE PENTRU UN ANUMIT SCOP.
Consultați Licența publică generală GNU pentru mai multe detalii.

Ar fi trebuit să primiți o copie a licenței publice generale GNU împreună cu acest program;
dacă nu, scrie la
Free Software Foundation, Inc.
51 Franklin Street, etajul cinci
Boston, MA 02110-1301 SUA

E-mail LISTA

Pentru ajutor și discuții despre utilizarea gccxml, o listă de corespondență este furnizată la
[e-mail protejat]. Vă rugăm să citiți mai întâi documentația completă la http://www.gccxml.org
înainte de a posta întrebări pe listă.

Utilizați gccxml online folosind serviciile onworks.net