gccxml — online w chmurze

PROGRAM:

IMIĘ

gccxml - Utwórz reprezentację XML deklaracji C++.

STRESZCZENIE

gccxml [opcje] -fxml=

OPIS

GCC-XML analizuje plik źródłowy C++ tak, jak widzi go kompilator podczas jego tworzenia. Łatwizna-
to-parse Reprezentacja XML deklaracji klasy, funkcji i przestrzeni nazw jest zrzucana
do określonego pliku. Pełne wstępne przetwarzanie C przekształca plik w jednostkę tłumaczącą C++
jak widzi kompilator. Oznacza to, że GCC-XML powinien korzystać z tego samego standardu
bibliotekę i inne pliki nagłówkowe jako kompilator. GCC-XML można skonfigurować tak, aby symulował dowolny
kilku popularnych kompilatorów.

OPCJE

Dostępne są następujące opcje uruchamiania GCC-XML:

--prawa autorskie
Wydrukuj prawa autorskie GCC-XML i wyjdź.

--odpluskwić
Wydrukuj dodatkowe informacje debugowania. Ta opcja powoduje, że GCC-XML drukuje plik
nazwa pliku wykonywalnego i argumenty wiersza poleceń używane do wykonania poprawionego GCC C++
parser. Jest to przydatne podczas próby symulacji nieobsługiwanego kompilatora.

-fxml=
Określ plik wyjściowy XML. Ta opcja jest przekazywana bezpośrednio do załatanego GCC
Parser C++. Umożliwia zrzut XML i określa nazwę pliku wyjściowego.

-fxml-start= [,...]
Określ listę deklaracji początkowych. Ta opcja jest przekazywana bezpośrednio do
poprawiony parser GCC C++. Ma znaczenie tylko wtedy, gdy określono również opcję -fxml=. Ten
określa oddzieloną przecinkami listę nazwanych deklaracji początkowych. GCC-XML zrzuci
tylko podzbiór deklaracji w jednostce translacji, który jest osiągalny
przez sekwencję odniesień źródłowych z jednego z określonych początkowych
deklaracje.

--gccxml-kompilator
Ustaw GCCXML_COMPILER na „xxx”.

--gccxml-cxxflags
Ustaw GCCXML_CXXFLAGS na „xxx”.

--gccxml-plik wykonywalny
Ustaw GCCXML_EXECUTABLE na „xxx”.

--gccxml-cpp
Ustaw GCCXML_CPP na „xxx”.

--gccxml-config
Ustaw GCCXML_CONFIG na „xxx”.

--gccxml-root
Ustaw GCCXML_ROOT na „xxx”.

--gccxml-gcc-opcje
Odczytaj opcje GCC z pliku „xxx”. Ta opcja określa plik, z którego ma zostać odczytany
opcje do przekazania do załatanego parsera GCC C++. Jest to przydatne do określenia a
długa lista katalogów dołączanych. Każda linia w pliku staje się jedną opcją. Pusty
linie i linie zaczynające się od '#' są ignorowane.

--help Wydrukuj pełną pomoc i wyjdź. Pełna pomoc wyświetla większość dokumentacji dostarczanej przez
strona podręcznika systemu UNIX. Jest przeznaczony do użytku na platformach innych niż UNIX, ale jest również dostępny
wygodne, jeśli strona podręcznika nie jest zainstalowana.

--pomoc-html
Wydrukuj pełną pomoc w formacie HTML. Ta opcja jest używana przez autorów GCC-XML jako pomoc
tworzyć strony internetowe.

--facet Wydrukuj stronę podręcznika systemu UNIX i wyjdź. Ta opcja jest używana przez autorów GCC-XML do generowania
strona podręcznika systemu UNIX.

--wydrukować
Wydrukuj ustawienia konfiguracji i wyjdź. GCC-XML ma wiele opcji konfiguracyjnych
pomóż mu symulować inny kompilator. Użycie tej opcji spowoduje, że GCC-XML
skonfigurować się tak, jakby zamierzał przeanalizować źródło C++, ale zatrzymać się i wydrukować
znaleziona konfiguracja. Jest to przydatne do sprawdzania konfiguracji.

--przetwarzanie wstępne
Wstępne przetwarzanie danych wejściowych i wyjściowych. GCC-XML symuluje procesor innego
kompilator. Użycie tej opcji spowoduje, że GCC-XML skonfiguruje się tak, jakby był
zamierzam przeanalizować źródło C++, ale zatrzymam się po wstępnym przetworzeniu. Jest to przydatne dla
debugowanie problemów związanych z symulacją drugiego kompilatora.

-E Alias ​​dla --preprocess.

--wersja
Pokaż baner nazwy/wersji programu i wyjdź.

Inne flagi, takie jak -I i -D, są przekazywane do załatanego pliku wykonywalnego parsera GCC C++.

USTAWIENIA

GCC-XML został zaprojektowany do symulacji parsera kompilatora podczas czytania kodu źródłowego C++. Niektóre
potrzebne są ustawienia konfiguracyjne, aby określić, jak symulować konkretny kompilator
wybór użytkownika. Do skonfigurowania GCC-XML można użyć następujących ustawień:

GCCXML_COMPILER
Symulowany kompilator C++. GCC-XML spróbuje automatycznie określić
jak symulować kompilator określony przez to ustawienie. Kompilator jest określony
według nazwy pliku wykonywalnego (takiego jak „g++”). W przypadku programu Visual Studio kompilator jest
określony przez "msvc6", "msvc7", "msvc71" lub "msvc8" (jeśli podano "cl", GCC-XML
próbuje odgadnąć, którego VS użyć).

GCCXML_CXXFLAGS
Flagi dla kompilatora C++, który ma być symulowany. Zachowanie większości kompilatorów może
można dostosować, określając flagi w wierszu poleceń. Kiedy GCC-XML próbuje
automatycznie określić, jak symulować kompilator, te flagi są brane pod uwagę
rozpatrzenie.

GCCXML_CONFIG
Plik konfiguracyjny dla typowych ustawień. Gdy ustawienia inne niż domyślne są często
używane, wygodnie jest napisać pojedynczy plik, który je zawiera. Kiedy taki plik jest
określony, zostanie odczytany w celu skonfigurowania wszelkich ustawień, które nie są jeszcze znane. Każdy
wiersz pliku składa się z jednego przypisania postaci KEY="VALUE" (np.
GCCXML_COMPILER="g++").

GCCXML_EXECUTABLE
Określ poprawiony plik wykonywalny parsera GCC C++. Program GCC-XML widziany przez
user jest w rzeczywistości front-endem, który określa flagi potrzebne do skonfigurowania
załatany parser GCC C++, aby symulować inny kompilator. To ustawienie określa
rzeczywisty plik wykonywalny do uruchomienia po ustaleniu flag. Użytkownicy powinni rzadko
należy zmienić tę wartość z domyślnej.

GCCXML_CPP
Określ plik wykonywalny preprocesora GCC C. Program GCC-XML widziany przez użytkownika
jest w rzeczywistości nakładką, która określa flagi potrzebne do skonfigurowania załatanej
Parser GCC C++ do symulacji innego kompilatora. To ustawienie określa
preprocesor do uruchamiania z flagami, które zostały określone do debugowania
cele. Użytkownicy rzadko powinni zmieniać tę wartość z domyślnej.

GCCXML_ROOT
Katalog biblioteki obsługi GCC-XML. Ponieważ GCC-XML jest tylko jednym parserem C++, to
nie może dokładnie powielić funkcjonalności każdego kompilatora, który próbuje symulować.
Niektóre kompilatory dostarczają standardowe nagłówki z kodem, którego GCC-XML nie może bezpośrednio
uchwyt. Aby obejść to ograniczenie, dla każdego z nich dostępna jest biblioteka pomocnicza
kompilator. Składa się z zestawu plików nagłówkowych, które są używane zamiast
nagłówki systemowe kompilatora. Te pliki zawierają niewielkie poprawki, a następnie zawierają rozszerzenie
odpowiedni rzeczywisty nagłówek. Korzeń drzewa katalogów zawierającego te wsparcie
nagłówki bibliotek są określone przez to ustawienie. Użytkownicy rzadko powinni potrzebować zmian
tę wartość od wartości domyślnej.

GCCXML_FLAGS
Flagi używane do symulacji innego kompilatora. Gdy GCC-XML uruchamia poprawiony GCC C++
parser, te flagi są przekazywane do programu, aby powiedzieć mu, jak symulować a
konkretny kompilator. To ustawienie jest zwykle wykrywane automatycznie z drugiego
ustawienia, ale mogą być określane bezpośrednio przez zaawansowanych użytkowników. Większość użytkowników powinna
nie próbuj zmieniać tej wartości z automatycznej konfiguracji.

GCCXML_USER_FLAGS
Dodatkowe flagi użytkownika do symulacji kompilatora. Gdy GCC-XML uruchamia poprawiony GCC
C++, te flagi są przekazywane oprócz tych określonych przez GCCXML_FLAGS.
Pozwala to zaawansowanym użytkownikom na dostrajanie symulacji kompilatora przy jednoczesnym korzystaniu z
automatyczna konfiguracja GCCXML_FLAGS. Użytkownicy rzadko powinni to zmieniać
wartość od wartości domyślnej.

Istnieje kilka sposobów konfigurowania tych ustawień. Są one wymienione tutaj w
kolejność pierwszeństwa (od najwyższego):

Wiersz poleceń Opcje
Ustawienia można określić za pomocą odpowiednich opcji. Kiedy ustawienie
dostępna jest odpowiednia opcja wiersza poleceń, jest ona używana na korzyść innych
środki konfiguracji. Jeśli GCCXML_CONFIG jest ustawiony w wierszu polecenia, ustawienia są
czytać z pliku z pierwszeństwem nieco niższym niż inne wiersze poleceń
opcje.

Środowisko Zmienne
Ustawienia są konfigurowane według nazwy w środowisku. Każde ustawienie nie jest już znane
jest odczytywany ze zmiennej środowiskowej wraz z jej nazwą. Jeśli GCCXML_CONFIG jest ustawiony przez
środowisku, ustawienia są odczytywane z pliku z nieznacznie niższym priorytetem
niż inne zmienne środowiskowe.

systemu Akta
Wykonywane jest wyszukiwanie GCCXML_CONFIG. Jeśli GCCXML_CONFIG nie został jeszcze ustawiony, an
zostanie podjęta próba automatycznego znalezienia pliku konfiguracyjnego. Po pierwsze, jeśli plik
$HOME/.gccxml/config istnieje, zostanie użyty. Po drugie, jeśli wykonywany jest GCC-XML
z jego katalogu kompilacji, zostanie użyty plik konfiguracyjny z tego katalogu. Wreszcie,
jeśli plik konfiguracyjny zostanie znaleziony w katalogu biblioteki pomocniczej instalacji, tak się stanie
być użytym. Po znalezieniu nieznane ustawienia są odczytywane z pliku konfiguracyjnego.

Zgadywanie
Zgadywania są dokonywane na podstawie innych ustawień. Po ustawieniu GCCXML_COMPILER jest
służy do automatycznego wyszukiwania ustawienia dla GCCXML_FLAGS. Jeśli nie jest ustawiony,
Zmienna środowiskowa „CXX” jest sprawdzana w ostateczności w celu znalezienia ustawienia kompilatora
i określ GCCXML_FLAGS.

Większość użytkowników nie powinna zmieniać ustawień domyślnych dla tych ustawień. Jest domyślna
Plik GCCXML_CONFIG dostarczony w katalogu biblioteki wsparcia po instalacji. To
konfiguruje GCC-XML do symulacji kompilatora, który został użyty do jego zbudowania.

KOMPILATORY

GCC-XML może symulować dowolny z następujących kompilatorów:

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

Wizualny C + +
Wersje 8, 7.1, 7.0 i 6 (sp5)

Borlanda, Intel, SGI
wcześniej obsługiwane, ale już nie testowane

Dostępne są następujące dodatkowe definicje preprocesora C:

-D__GCCXML__=MMmmpp
MM, mm i pp to główne, pomocnicze i łatki wersji GCC-XML. Ten
symbol preprocesora identyfikuje GCC-XML z kodem źródłowym podczas jego wstępnego przetwarzania.
Można go użyć do włączenia informacji specyficznych dla GCC-XML.

-D__GCCXML_GNUC__=M
Zdefiniowany jako główna wersja wewnętrznego parsera GCC.

-D__GCCXML_GNUC_MINOR__=m
Zdefiniowany jako podrzędna wersja wewnętrznego parsera GCC.

-D__GCCXML_GNUC_PATCHLEVEL__=str
Zdefiniowany jako wewnętrzny poziom poprawek parsera GCC.

Zaawansowani użytkownicy mogą symulować inne kompilatory, ręcznie konfigurując plik GCCXML_FLAGS
ustawienie. Skontaktuj się z listą mailingową, aby uzyskać pomoc.

METAINFORMACJE

GCC-XML dodał nowy atrybut do legalnego zestawu atrybutów C/C++. Atrybut jest
używany do dołączania metainformacji do kodu źródłowego C/C++, który następnie pojawi się w XML
wyjście. Składnia deklaracji atrybutu jest następująca:

__attribute((gccxml( , , ...)))
Tutaj jest ciągiem ujętym w cudzysłów. Musi istnieć co najmniej jeden argument przemawiający za
„gccxml”, ale nie ma górnego limitu całkowitej liczby argumentów.
Każdy argument jest weryfikowany jako łańcuch — jeśli zostanie znaleziony argument inny niż łańcuch,
atrybut jest ignorowany.

Dane wyjściowe XML dla elementu kodu, który jest oznaczony atrybutem, będą zawierać
następujące brzmienie:

atrybuty=" ... gccxml( , , ...) ...
Atrybut XML „atrybuty” zawiera wszystkie atrybuty zastosowane do elementu kodu.
Każdy argument atrybutu jest drukowany bez cudzysłowów, więc jeśli an
argument zawiera znak „,”, argument będzie wyglądał na wielokrotny
argumenty.

Atrybut „gccxml” można zastosować do dowolnej deklaracji, w tym struktur, klas,
pola, parametry, metody, funkcje, zmienne i definicje typów. Jedynym wyjątkiem jest
że obsługa GCC elementu języka „__attribute” jest obecnie zepsuta
wyliczenia i konstruktory z wstawioną treścią. Można użyć atrybutu „gccxml”.
dowolną ilość razy na danej deklaracji.

Jako przykład tego, jak ten atrybut może być użyty do dołączenia metainformacji do C++
deklaracje, rozważ następujące makro:

#definiować _na zewnątrz_ __attribute((gccxml("out")))
Tutaj „_out_” został zdefiniowany jako atrybut gccxml, gdzie pierwszy argument
jest ciągiem „out”. Zaleca się, aby pierwszy argument był używany jako unikatowy
nazwa ciągu dla rodzaju metainformacji rozpocząć zastosowanie.

Teraz deklarację metody można zapisać w następujący sposób:

unieważnić getInteger(_out_ int& ja);
Spowoduje to, że dane wyjściowe XML będą zawierać metainformacje dla „_out_”
atrybut w postaci „gccxml(out)”.

Użycie atrybutu „gccxml” umożliwia dołączanie metainformacji bezpośrednio do języka C++
kodu źródłowego, bez potrzeby używania niestandardowego parsera do wyodrębniania metainformacji. The
Atrybut „gccxml” jest dostarczany wyłącznie dla wygody — nie ma gwarancji, że w przyszłości
wersje GCC będą akceptować element języka „__attribute” w sposób wolny od błędów.

PRAWA AUTORSKIE

GCC-XML — wyjście XML dla GCC

Prawa autorskie 2002-2012 Kitware, Inc., konsorcjum Insight

Redystrybucja i wykorzystanie w formie źródłowej i binarnej, z modyfikacją lub bez, są
dozwolone pod warunkiem spełnienia następujących warunków:

* Redystrybucje kodu źródłowego muszą zawierać powyższą informację o prawach autorskich, tę listę
warunki i następujące wyłączenie odpowiedzialności.

* Redystrybucje w formie binarnej muszą zawierać powyższą informację o prawach autorskich, tę listę
warunków i poniższego zastrzeżenia w dokumentacji i/lub innych
materiały dostarczone wraz z dystrybucją.

* Ani nazwy Kitware, Inc., Insight Software Consortium, ani nazwy
ich współtwórców mogą być wykorzystywane do promowania lub promowania produktów pochodzących z tego
oprogramowanie bez uprzedniej pisemnej zgody.

NINIEJSZE OPROGRAMOWANIE JEST DOSTARCZANE PRZEZ WŁAŚCICIELI PRAW AUTORSKICH I WSPÓŁPRACOWNIKÓW „TAK JAK JEST”, A WSZELKIE
WYRAŹNE LUB DOROZUMIANE GWARANCJE, W TYM MIĘDZY INNYMI DOROZUMIANE GWARANCJE
WYŁĄCZA SIĘ PRZYDATNOŚĆ HANDLOWĄ I PRZYDATNOŚĆ DO OKREŚLONEGO CELU. W ŻADNYM WYPADKU NIE BĘDZIE
WŁAŚCICIELE PRAW AUTORSKICH LUB WSPÓŁPRACOWNICY PONOSZĄ ODPOWIEDZIALNOŚĆ ZA JAKIEKOLWIEK BEZPOŚREDNIE, POŚREDNIE, PRZYPADKOWE, SZCZEGÓLNE,
PRZYKŁADOWE LUB WTÓRNE SZKODY (W TYM, MIĘDZY INNYMI, NABYCIA
ZASTĘPCZYCH TOWARÓW LUB USŁUG; UTRATA MOŻLIWOŚCI UŻYTKOWANIA, DANYCH LUB ZYSKÓW; LUB PRZERWY W BIZNESIE)
BEZ JAKIEGOKOLWIEK PRZYCZYNY I NA JAKIEJKOLWIEK TEORII ODPOWIEDZIALNOŚCI, CZY TO W KONTRAKCIE, ŚCISŁEJ ODPOWIEDZIALNOŚCI LUB
DELIKTY (W TYM ZANIEDBANIE LUB INNE WYPADKI) WYNIKAJĄCE W JAKIKOLWIEK SPOSÓB Z KORZYSTANIA Z NINIEJSZEJ
OPROGRAMOWANIE, NAWET JEŚLI POWINIONO O MOŻLIWOŚCI WYSTĄPIENIA TAKICH USZKODZEŃ.

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

gccxml_cc1plus — parser GCC z łatką dla zrzutów XML jednostek tłumaczeniowych

Prawa autorskie 2002-2012 Kitware, Inc., konsorcjum Insight

Ten program jest wolnym oprogramowaniem; możesz go redystrybuować i/lub modyfikować na warunkach
Powszechna Licencja Publiczna GNU opublikowana przez Free Software Foundation; albo
wersja 2 Licencji lub (według Twojego wyboru) dowolna nowsza wersja.

Ten program jest rozpowszechniany w nadziei, że będzie przydatny, ale BEZ ŻADNEJ GWARANCJI;
bez dorozumianej gwarancji PRZYDATNOŚCI HANDLOWEJ lub PRZYDATNOŚCI DO OKREŚLONEGO CELU.
Więcej szczegółów znajdziesz w Powszechnej Licencji Publicznej GNU.

Wraz z tym programem powinieneś otrzymać kopię Powszechnej Licencji Publicznej GNU;
jeśli nie, napisz do
Free Software Foundation, Inc.
51 Franklin Street, piąte piętro
Boston, MA 02110-1301 Stany Zjednoczone

POCZTA WYKAZ

Aby uzyskać pomoc i dyskusję na temat korzystania z gccxml, dostępna jest lista mailingowa pod adresem
[email chroniony]. Najpierw przeczytaj pełną dokumentację pod adresem http://www.gccxml.org
przed wysłaniem pytań na listę.

Korzystaj z gccxml online, korzystając z usług onworks.net