gccxml - Dalam talian dalam Awan

JADUAL:

NAMA

gccxml - Buat perwakilan XML bagi pengisytiharan C++.

SINOPSIS

gccxml [pilihan] -fxml=

DESCRIPTION

GCC-XML menghuraikan fail sumber C++ kerana ia dilihat oleh pengkompil apabila ia dibina. mudah-
untuk menghuraikan perwakilan XML bagi kelas, fungsi dan pengisytiharan ruang nama dibuang
kepada fail tertentu. Prapemprosesan penuh C mengubah fail menjadi unit terjemahan C++
seperti yang dilihat oleh penyusun. Ini bermakna GCC-XML harus menggunakan standard yang sama
perpustakaan dan fail pengepala lain sebagai pengkompil. GCC-XML boleh dikonfigurasikan untuk mensimulasikan mana-mana
daripada beberapa penyusun popular.

PILIHAN

Pilihan berikut tersedia untuk menjalankan GCC-XML:

--hak cipta
Cetak hak cipta GCC-XML dan keluar.

--nyahpepijat
Cetak maklumat penyahpepijatan tambahan. Pilihan ini menyebabkan GCC-XML mencetak
nama boleh laku dan argumen baris perintah yang digunakan untuk melaksanakan GCC C++ yang ditampal
penghurai. Ini berguna apabila cuba mensimulasikan pengkompil yang tidak disokong.

-fxml=
Tentukan fail output XML. Pilihan ini dihantar terus ke GCC yang ditambal
Penghurai C++. Ia membolehkan pembuangan XML dan menentukan nama fail output.

-fxml-start= [,...]
Tentukan senarai pengisytiharan permulaan. Pilihan ini dihantar terus ke
penghurai GCC C++ yang ditampal. Ia bermakna hanya jika -fxml= juga dinyatakan. ini
menentukan senarai yang dipisahkan koma bagi pengisytiharan permulaan bernama. GCC-XML akan membuang
hanya subset pengisytiharan dalam unit terjemahan yang boleh dicapai
melalui urutan rujukan sumber daripada salah satu permulaan yang ditentukan
pengisytiharan.

--gccxml-compiler
Tetapkan GCCXML_COMPILER kepada "xxx".

--gccxml-cxxflags
Tetapkan GCCXML_CXXFLAGS kepada "xxx".

--gccxml-boleh laku
Tetapkan GCCXML_EXECUTABLE kepada "xxx".

--gccxml-cpp
Tetapkan GCCXML_CPP kepada "xxx".

--gccxml-config
Tetapkan GCCXML_CONFIG kepada "xxx".

--gccxml-root
Tetapkan GCCXML_ROOT kepada "xxx".

--gccxml-gcc-options
Baca pilihan GCC daripada fail "xxx". Pilihan ini menentukan fail untuk dibaca
pilihan untuk dihantar ke penghurai GCC C++ yang ditampal. Ini berguna untuk menentukan a
senarai panjang termasuk direktori. Setiap baris dalam fail menjadi satu pilihan. kosong
baris dan baris yang bermula dengan '#' diabaikan.

- membantu Cetak bantuan penuh dan keluar. Bantuan penuh memaparkan kebanyakan dokumentasi yang disediakan oleh
halaman lelaki UNIX. Ia disediakan untuk digunakan pada platform bukan UNIX, tetapi juga
mudah jika halaman manual tidak dipasang.

--help-html
Cetak bantuan penuh dalam format HTML. Pilihan ini digunakan oleh pengarang GCC-XML untuk membantu
menghasilkan halaman web.

--lelaki Cetak halaman lelaki UNIX dan keluar. Pilihan ini digunakan oleh pengarang GCC-XML untuk menjana
halaman lelaki UNIX.

--cetak
Cetak tetapan konfigurasi dan keluar. GCC-XML mempunyai banyak pilihan konfigurasi
membantunya mensimulasikan pengkompil lain. Menggunakan pilihan ini akan menyebabkan GCC-XML menjadi
konfigurasikan dirinya seolah-olah ia akan menghuraikan sumber C++, tetapi berhenti dan cetak
konfigurasi yang ditemui. Ini berguna untuk menyemak konfigurasi.

--praproses
Praproses input dan keluar. GCC-XML mensimulasikan pemproses yang lain
penyusun. Menggunakan pilihan ini akan menyebabkan GCC-XML mengkonfigurasi dirinya seolah-olah
akan menghuraikan sumber C++, tetapi berhenti selepas prapemprosesan. Ini berguna untuk
masalah penyahpepijatan yang berkaitan dengan simulasi pengkompil yang lain.

-E Alias ​​untuk --praproses.

--versi
Tunjukkan sepanduk nama/versi program dan keluar.

Bendera lain, seperti -I dan -D, diserahkan kepada penghurai GCC C++ yang boleh dieksekusi.

SETTINGS

GCC-XML direka bentuk untuk mensimulasikan penghurai pengkompil semasa membaca kod sumber C++. Beberapa
tetapan konfigurasi diperlukan untuk menentukan cara mensimulasikan pengkompil tertentu
pilihan pengguna. Tetapan berikut boleh digunakan untuk mengkonfigurasi GCC-XML:

GCCXML_COMPILER
Pengkompil C++ untuk disimulasikan. GCC-XML akan cuba menentukan secara automatik
bagaimana untuk mensimulasikan pengkompil yang ditentukan oleh tetapan ini. Pengkompil ditentukan
dengan nama boleh lakunya (seperti "g++"). Untuk Visual Studio, pengkompil ialah
ditentukan oleh "msvc6", "msvc7", "msvc71", atau "msvc8" (jika "cl" diberikan, GCC-XML
cuba meneka VS mana yang hendak digunakan).

GCCXML_CXXFLAGS
Bendera untuk pengkompil C++ untuk disimulasikan. Tingkah laku kebanyakan penyusun boleh
dilaraskan dengan menyatakan bendera pada baris arahan. Apabila GCC-XML cuba untuk
secara automatik menentukan cara untuk mensimulasikan pengkompil, bendera ini diambil
pertimbangan.

GCCXML_CONFIG
Fail konfigurasi untuk tetapan biasa. Apabila tetapan bukan lalai selalunya
digunakan, adalah mudah untuk menulis satu fail yang mengandunginya. Apabila fail sedemikian adalah
ditentukan, ia akan dibaca untuk mengkonfigurasi sebarang tetapan yang belum diketahui. setiap satu
baris fail terdiri daripada satu tugasan borang KEY="VALUE" (contohnya,
GCCXML_COMPILER="g++").

GCCXML_EXECUTABLE
Tentukan penghurai GCC C++ yang boleh dieksekusi. Program GCC-XML seperti yang dilihat oleh
pengguna sebenarnya adalah bahagian hadapan yang menentukan bendera yang diperlukan untuk mengkonfigurasi
menampal penghurai GCC C++ untuk mensimulasikan pengkompil lain. Tetapan ini menentukan
boleh laku sebenar untuk dijalankan sebaik sahaja bendera ditentukan. Pengguna sepatutnya jarang
perlu menukar nilai ini daripada lalainya.

GCCXML_CPP
Tentukan prapemproses GCC C boleh laku. Program GCC-XML seperti yang dilihat oleh pengguna
sebenarnya adalah bahagian hadapan yang menentukan bendera yang diperlukan untuk mengkonfigurasi yang ditampal
Penghurai GCC C++ untuk mensimulasikan pengkompil lain. Tetapan ini menentukan
prapemproses untuk dijalankan dengan bendera yang telah ditentukan untuk penyahpepijatan
tujuan. Pengguna sepatutnya jarang perlu menukar nilai ini daripada lalainya.

GCCXML_ROOT
Direktori perpustakaan sokongan GCC-XML. Oleh kerana GCC-XML hanyalah satu penghurai C++, ia
tidak boleh betul-betul menduplikasi kefungsian setiap pengkompil yang cuba disimulasikan.
Sesetengah penyusun menyediakan pengepala standard dengan kod yang GCC-XML tidak boleh secara langsung
mengendalikan. Untuk mengatasi had ini, perpustakaan sokongan disediakan untuk setiap satu
penyusun. Ini terdiri daripada satu set fail pengepala yang digunakan sebagai ganti fail
pengepala sistem pengkompil. Fail ini mengandungi sedikit tweak dan kemudian masukkan fail
pengepala sebenar yang sepadan. Akar pokok direktori yang mengandungi sokongan ini
pengepala perpustakaan ditentukan oleh tetapan ini. Pengguna sepatutnya jarang perlu menukar
nilai ini daripada lalainya.

GCCXML_FLAGS
Bendera digunakan untuk mensimulasikan pengkompil yang lain. Apabila GCC-XML menjalankan GCC C++ yang ditampal
parser, bendera ini dihantar kepada program untuk memberitahunya cara mensimulasikan a
penyusun tertentu. Tetapan ini biasanya dikesan secara automatik daripada yang lain
tetapan, tetapi ia boleh ditentukan secara langsung oleh pengguna lanjutan. Kebanyakan pengguna sepatutnya
tidak cuba menukar nilai ini daripada konfigurasi automatik.

GCCXML_USER_FLAGS
Bendera pengguna tambahan untuk simulasi pengkompil. Apabila GCC-XML menjalankan GCC yang ditambal
Penghurai C++, bendera ini dihantar sebagai tambahan kepada yang ditentukan oleh GCCXML_FLAGS.
Ini membolehkan pengguna lanjutan untuk mengubah suai simulasi pengkompil semasa masih menggunakan
konfigurasi automatik GCCXML_FLAGS. Pengguna sepatutnya jarang perlu menukar ini
nilai daripada lalainya.

Terdapat beberapa cara di mana tetapan ini dikonfigurasikan. Mereka disenaraikan di sini dalam
susunan keutamaan (tertinggi dahulu):

Barisan arahan Pilihan
Tetapan boleh ditentukan oleh pilihan yang sepadan. Apabila tetapan
pilihan baris arahan yang sepadan disediakan, ia digunakan memihak kepada mana-mana yang lain
cara konfigurasi. Jika GCCXML_CONFIG ditetapkan pada baris arahan, tetapan adalah
baca dari fail dengan keutamaan hanya sedikit lebih rendah daripada baris arahan lain
pilihan.

alam Sekitar Pembolehubah
Tetapan dikonfigurasikan mengikut nama dalam persekitaran. Setiap tetapan belum diketahui
dibaca daripada pembolehubah persekitaran dengan namanya. Jika GCCXML_CONFIG ditetapkan oleh
persekitaran, tetapan dibaca daripada fail dengan keutamaan hanya sedikit lebih rendah
daripada pembolehubah persekitaran yang lain.

konfigurasi Fail
Carian untuk GCCXML_CONFIG dilakukan. Jika GCCXML_CONFIG masih belum ditetapkan, a
percubaan dibuat untuk mencari fail konfigurasi secara automatik. Pertama, jika fail
$HOME/.gccxml/config wujud, ia akan digunakan. Kedua, jika GCC-XML sedang dilaksanakan
daripada direktori binaannya, fail konfigurasi daripada direktori itu akan digunakan. Akhirnya,
jika fail konfigurasi ditemui dalam direktori perpustakaan sokongan pemasangan, ia akan
digunakan. Setelah ditemui, sebarang tetapan yang tidak diketahui dibaca daripada fail konfigurasi.

Meneka
Tekaan dibuat berdasarkan tetapan lain. Sebaik sahaja GCCXML_COMPILER telah ditetapkan, ia adalah
digunakan untuk mencari tetapan untuk GCCXML_FLAGS secara automatik. Jika ia tidak ditetapkan, yang
Pembolehubah persekitaran "CXX" disemak sebagai pilihan terakhir untuk mencari tetapan pengkompil
dan tentukan GCCXML_FLAGS.

Kebanyakan pengguna tidak perlu melaraskan lalai untuk tetapan ini. Terdapat lalai
Fail GCCXML_CONFIG disediakan dalam direktori perpustakaan sokongan selepas pemasangan. Ia
mengkonfigurasi GCC-XML untuk mensimulasikan pengkompil yang digunakan untuk membinanya.

PENYUSUN

GCC-XML boleh mensimulasikan mana-mana penyusun berikut:

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

visual C + +
Versi 8, 7.1, 7.0 dan 6 (sp5)

Borland, intel, SGI
dahulunya disokong tetapi tidak lagi diuji

Takrifan prapemproses C tambahan berikut disediakan:

-D__GCCXML__=MMmmpp
MM, mm dan pp ialah versi major, minor dan patch GCC-XML. ini
simbol prapemproses mengenal pasti GCC-XML kepada kod sumber kerana ia dipraproses.
Ia boleh digunakan untuk mendayakan maklumat khusus GCC-XML.

-D__GCCXML_GNUC__=M
Ditakrifkan kepada versi utama parser GCC dalaman.

-D__GCCXML_GNUC_MINOR__=m
Ditakrifkan kepada versi minor parser GCC dalaman.

-D__GCCXML_GNUC_PATCHLEVEL__=p
Ditakrifkan kepada tahap tampalan parser GCC dalaman.

Pengguna lanjutan boleh mensimulasikan pengkompil lain dengan mengkonfigurasi GCCXML_FLAGS secara manual
tetapan. Hubungi senarai mel untuk mendapatkan bantuan.

METAINFO

GCC-XML telah menambahkan atribut baharu pada set undang-undang atribut C/C++. Atributnya ialah
digunakan untuk melampirkan maklumat meta pada kod sumber C/C++, yang kemudiannya akan muncul dalam XML
pengeluaran. Sintaks untuk mengisytiharkan atribut adalah seperti berikut:

__attribute((gccxml( , , ...)))
Di sini ialah rentetan yang dipetik. Mesti ada sekurang-kurangnya satu hujah kepada
atribut 'gccxml', tetapi tiada had atas kepada jumlah bilangan argumen.
Setiap hujah disahkan sebagai rentetan - jika hujah bukan rentetan ditemui, hujah
atribut diabaikan.

Output XML untuk elemen kod yang ditag dengan atribut kemudiannya akan mengandungi
yang berikut:

atribut=" ... gccxml( , , ...) ...
Atribut XML 'atribut' mengandungi semua atribut yang digunakan pada elemen kod.
Setiap hujah atribut dicetak tanpa melampirkan petikan, jadi jika an
argumen mengandungi aksara ',', hujah akan kelihatan berbilang
hujah-hujah.

Atribut 'gccxml' boleh digunakan pada sebarang pengisytiharan termasuk struct, kelas,
medan, parameter, kaedah, fungsi, pembolehubah dan typedef. Satu-satunya pengecualian ialah
bahawa pengendalian GCC terhadap elemen bahasa '__attribute' pada masa ini tidak berfungsi
penghitungan dan pembina dengan badan sebaris. Atribut 'gccxml' boleh digunakan
beberapa kali pada pengisytiharan yang diberikan.

Sebagai contoh bagaimana atribut ini boleh digunakan untuk melampirkan maklumat meta pada C++
perisytiharan, pertimbangkan makro berikut:

#tentukan _keluar_ __attribute((gccxml("keluar")))
Di sini '_out_' telah ditakrifkan sebagai atribut gccxml di mana hujah pertama
ialah rentetan "keluar". Adalah disyorkan bahawa hujah pertama digunakan sebagai unik
nama rentetan untuk jenis maklumat meta mula digunakan.

Sekarang pengisytiharan kaedah boleh ditulis seperti berikut:

membatalkan getInteger(_out_ int& i);
Ini akan menyebabkan output XML mengandungi maklumat meta untuk '_out_'
atribut, dalam bentuk "gccxml(out)".

Menggunakan atribut 'gccxml' membolehkan maklumat meta dimasukkan terus dalam C++
kod sumber, tanpa memerlukan penghurai tersuai untuk mengekstrak maklumat meta. The
Atribut 'gccxml' disediakan untuk kemudahan sahaja - tiada jaminan masa depan itu
versi GCC akan menerima elemen bahasa '__attribute' dengan cara bebas pepijat.

HAKCIPTA

GCC-XML - Output XML untuk GCC

Hak Cipta 2002-2012 Kitware, Inc., Insight Consortium

Pengagihan semula dan penggunaan dalam bentuk sumber dan binari, dengan atau tanpa pengubahsuaian, adalah
dibenarkan dengan syarat syarat berikut dipenuhi:

* Pengagihan semula kod sumber mesti mengekalkan notis hak cipta di atas, senarai ini
syarat dan penafian berikut.

* Pengagihan semula dalam bentuk binari mesti mengeluarkan semula notis hak cipta di atas, senarai ini
syarat dan penafian berikut dalam dokumentasi dan/atau lain-lain
bahan yang disediakan bersama pengedaran.

* Baik nama Kitware, Inc., Konsortium Perisian Insight, mahupun nama
daripada penyumbang mereka boleh digunakan untuk menyokong atau mempromosikan produk yang diperoleh daripada ini
perisian tanpa kebenaran bertulis khusus terlebih dahulu.

PERISIAN INI DISEDIAKAN OLEH PEMEGANG HAK CIPTA DAN PENYUMBANG "SEBAGAIMANA ADANYA" DAN MANA-MANA
WARANTI NYATA ATAU TERSIRAT, TERMASUK, TETAPI TIDAK TERHAD KEPADA, WARANTI TERSIRAT
KEBOLEHDAGANGAN DAN KESESUAIAN UNTUK TUJUAN TERTENTU ADALAH DITOLAK. DALAM APA APA PUN AKAN
PEMEGANG HAK CIPTA ATAU PENYUMBANG BERTANGGUNGJAWAB UNTUK SEBARANG LANGSUNG, TIDAK LANGSUNG, SAMPINGAN, KHAS,
CONTOH, ATAU KEROSAKAN AKIBAT (TERMASUK, TETAPI TIDAK TERHAD KEPADA, PEROLEHAN
GANTI BARANG ATAU PERKHIDMATAN; KEHILANGAN PENGGUNAAN, DATA ATAU KEUNTUNGAN; ATAU GANGGUAN PERNIAGAAN)
BAGAIMANA CARANYA DAN ATAS MANA-MANA ​​TEORI LIABILITI, SAMA ADA DALAM KONTRAK, LIABILITI KETAT ATAU
TORT (TERMASUK KECUAIAN ATAU SEBALIKNYA) YANG TIMBUL DALAM MANA-MANA ​​CARA DARI PENGGUNAAN INI
PERISIAN, WALAUPUN JIKA DITINGKATKAN KEMUNGKINAN KEROSAKAN SEPERTI.

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

gccxml_cc1plus - Penghurai GCC ditampal untuk pembuangan XML unit terjemahan

Hak Cipta 2002-2012 Kitware, Inc., Insight Consortium

Program ini adalah perisian percuma; anda boleh mengagihkannya semula dan/atau mengubah suainya di bawah syarat
Lesen Awam Am GNU seperti yang diterbitkan oleh Yayasan Perisian Percuma; sama ada
versi 2 Lesen, atau (mengikut pilihan anda) mana-mana versi kemudian.

Program ini diedarkan dengan harapan ia akan berguna, tetapi TANPA SEBARANG WARANTI;
tanpa jaminan tersirat KEBOLEHPERDAGANGAN atau KESESUAIAN UNTUK TUJUAN TERTENTU.
Lihat Lesen Awam Am GNU untuk butiran lanjut.

Anda sepatutnya menerima salinan Lesen Awam Am GNU bersama-sama dengan program ini;
jika tidak, tulis kepada
Free Software Foundation, Inc.
51 Franklin Street, Tingkat Lima
Boston, MA 02110-1301 Amerika Syarikat

PENGHANTARAN SENARAI

Untuk bantuan dan perbincangan tentang menggunakan gccxml, senarai mel disediakan di
[e-mel dilindungi]. Sila baca dahulu dokumentasi penuh di http://www.gccxml.org
sebelum menghantar soalan ke senarai.

Gunakan gccxml dalam talian menggunakan perkhidmatan onworks.net