gccxml - Online di Cloud

PROGRAM:

NAMA

gccxml - Buat representasi XML dari deklarasi C++.

RINGKASAN

gccxml [opsi] -fxml=

DESKRIPSI

GCC-XML mem-parsing file sumber C++ seperti yang terlihat oleh kompiler saat dibuat. Mudah-
untuk mengurai representasi XML dari deklarasi kelas, fungsi, dan namespace dibuang
ke file tertentu. Pemrosesan awal C penuh mengubah file menjadi unit terjemahan C++
seperti yang terlihat oleh kompiler. Ini berarti bahwa GCC-XML harus menggunakan standar yang sama
library dan file header lainnya sebagai compiler. GCC-XML dapat dikonfigurasi untuk mensimulasikan apapun
dari beberapa kompiler populer.

PILIHAN

Opsi berikut tersedia untuk menjalankan GCC-XML:

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

--debug
Cetak informasi debug tambahan. Opsi ini menyebabkan GCC-XML mencetak
nama yang dapat dieksekusi dan argumen baris perintah yang digunakan untuk mengeksekusi GCC C++ yang ditambal
pengurai. Ini berguna saat mencoba mensimulasikan kompiler yang tidak didukung.

-fxml=
Tentukan file keluaran XML. Opsi ini diteruskan langsung ke GCC yang ditambal
pengurai C++. Ini memungkinkan dump XML dan menentukan nama file output.

-fxml-mulai= [,...]
Tentukan daftar deklarasi awal. Opsi ini diteruskan langsung ke
parser GCC C++ yang ditambal. Ini berarti hanya jika -fxml= juga ditentukan. Ini
menentukan daftar yang dipisahkan koma dari deklarasi awal bernama. GCC-XML akan dibuang
hanya bagian dari deklarasi dalam unit terjemahan yang dapat dijangkau
melalui urutan referensi sumber dari salah satu awal yang ditentukan
deklarasi.

--gccxml-kompiler
Setel GCCXML_COMPILER ke "xxx".

--gccxml-cxxflags
Setel GCCXML_CXXFLAGS ke "xxx".

--gccxml-dapat dieksekusi
Setel GCCXML_EXECUTABLE ke "xxx".

--gccxml-cpp
Setel GCCXML_CPP ke "xxx".

--gccxml-config
Setel GCCXML_CONFIG ke "xxx".

--gccxml-root
Setel GCCXML_ROOT ke "xxx".

--gccxml-gcc-opsi
Baca opsi GCC dari file "xxx". Opsi ini menentukan file yang akan dibaca
opsi untuk diteruskan ke parser GCC C++ yang ditambal. Ini berguna untuk menentukan
daftar panjang termasuk direktori. Setiap baris dalam file menjadi satu opsi. Kosong
garis dan garis yang dimulai dengan '#' diabaikan.

--membantu Cetak bantuan penuh dan keluar. Bantuan penuh menampilkan sebagian besar dokumentasi yang disediakan oleh
halaman manual UNIX. Ini disediakan untuk digunakan pada platform non-UNIX, tetapi juga
nyaman jika halaman manual tidak diinstal.

--bantuan-html
Cetak bantuan penuh dalam format HTML. Opsi ini digunakan oleh penulis GCC-XML untuk membantu
menghasilkan halaman web.

--pria Cetak halaman manual UNIX dan keluar. Opsi ini digunakan oleh penulis GCC-XML untuk menghasilkan
halaman manual UNIX.

--mencetak
Cetak pengaturan konfigurasi dan keluar. GCC-XML memiliki banyak opsi konfigurasi untuk
membantunya mensimulasikan kompiler lain. Menggunakan opsi ini akan menyebabkan GCC-XML untuk
konfigurasikan dirinya seolah-olah akan mengurai sumber C++, tetapi berhenti dan cetak
konfigurasi yang ditemukan. Ini berguna untuk memeriksa konfigurasi.

--praproses
Praproses input dan keluar. GCC-XML mensimulasikan proprosesor lain
penyusun. Menggunakan opsi ini akan menyebabkan GCC-XML mengonfigurasi dirinya sendiri seolah-olah
akan mengurai sumber C++, tetapi berhenti setelah preprocessing. Ini berguna untuk
debugging masalah yang berkaitan dengan simulasi compiler lain.

-E Alias ​​​​untuk --preprocess.

--Versi: kapan
Tampilkan spanduk nama/versi program dan keluar.

Bendera lain, seperti -I dan -D, diteruskan ke parser GCC C++ yang dapat dieksekusi yang ditambal.

PENGATURAN

GCC-XML dirancang untuk mensimulasikan pengurai kompiler saat membaca kode sumber C++. Beberapa
pengaturan konfigurasi diperlukan untuk menentukan cara mensimulasikan kompiler tertentu dari
pilihan pengguna. Setelan berikut dapat digunakan untuk mengonfigurasi GCC-XML:

GCCXML_COMPILER
Kompiler C++ yang akan disimulasikan. GCC-XML akan mencoba untuk secara otomatis menentukan
cara mensimulasikan kompiler yang ditentukan oleh pengaturan ini. Kompiler ditentukan
dengan nama yang dapat dieksekusi (seperti "g++"). Untuk Visual Studio, kompilernya adalah
ditentukan oleh "msvc6", "msvc7", "msvc71", atau "msvc8" (jika "cl" diberikan, GCC-XML
mencoba menebak VS mana yang akan digunakan).

GCCXML_CXXFLAGS
Bendera untuk kompiler C++ yang akan disimulasikan. Perilaku sebagian besar kompiler dapat
disesuaikan dengan menentukan flag pada baris perintah. Ketika GCC-XML mencoba untuk
secara otomatis menentukan cara mensimulasikan kompiler, flag-flag ini dimasukkan ke dalam
pertimbangan.

GCCXML_CONFIG
File konfigurasi untuk pengaturan umum. Ketika pengaturan non-default sering
digunakan, akan lebih mudah untuk menulis satu file yang berisi mereka. Ketika file seperti itu adalah
ditentukan, itu akan dibaca untuk mengonfigurasi pengaturan apa pun yang belum diketahui. Setiap
baris file terdiri dari satu tugas dalam bentuk KEY="VALUE" (misalnya,
GCCXML_COMPILER="g++").

GCCXML_EXECUTABLE
Tentukan parser GCC C++ yang ditambal yang dapat dieksekusi. Program GCC-XML seperti yang terlihat oleh
pengguna sebenarnya adalah front-end yang menentukan flag yang diperlukan untuk mengonfigurasi
parser GCC C++ yang ditambal untuk mensimulasikan kompiler lain. Pengaturan ini menentukan
real executable untuk dijalankan setelah flag ditentukan. Pengguna seharusnya jarang
perlu mengubah nilai ini dari defaultnya.

GCCXML_CPP
Tentukan preprosesor GCC C yang dapat dieksekusi. Program GCC-XML seperti yang terlihat oleh pengguna
sebenarnya adalah front-end yang menentukan flag yang diperlukan untuk mengonfigurasi yang ditambal
GCC C++ parser untuk mensimulasikan compiler lain. Pengaturan ini menentukan
preprocessor untuk dijalankan dengan flag yang telah ditentukan untuk debugging
tujuan. Pengguna jarang perlu mengubah nilai ini dari defaultnya.

GCCXML_ROOT
Direktori pustaka dukungan GCC-XML. Karena GCC-XML hanya satu parser C++, itu
tidak dapat secara tepat menduplikasi fungsionalitas dari setiap kompiler yang coba disimulasikan.
Beberapa kompiler menyediakan tajuk standar dengan kode yang tidak dapat langsung dilakukan oleh GCC-XML
menangani. Untuk mengatasi batasan ini, perpustakaan dukungan disediakan untuk masing-masing
penyusun. Ini terdiri dari satu set file header yang digunakan sebagai pengganti
header sistem compiler. File-file ini berisi sedikit penyesuaian dan kemudian menyertakan:
header nyata yang sesuai. Akar pohon direktori yang berisi dukungan ini
header perpustakaan ditentukan oleh pengaturan ini. Pengguna seharusnya jarang perlu berubah
nilai ini dari defaultnya.

GCCXML_FLAGS
Bendera digunakan untuk mensimulasikan kompiler lain. Saat GCC-XML menjalankan GCC C++ yang ditambal
parser, flag-flag ini diteruskan ke program untuk memberi tahu cara mensimulasikan a
kompiler tertentu. Pengaturan ini biasanya terdeteksi secara otomatis dari yang lain
pengaturan, tetapi dapat ditentukan langsung oleh pengguna tingkat lanjut. Sebagian besar pengguna harus
tidak mencoba mengubah nilai ini dari konfigurasi otomatis.

GCCXML_USER_FLAGS
Bendera pengguna tambahan untuk simulasi kompiler. Saat GCC-XML menjalankan GCC yang ditambal
C++ parser, flag ini diteruskan selain yang ditentukan oleh GCCXML_FLAGS.
Ini memungkinkan pengguna tingkat lanjut untuk men-tweak simulasi kompiler saat masih menggunakan
konfigurasi otomatis GCCXML_FLAGS. Pengguna seharusnya jarang perlu mengubah ini
nilai dari defaultnya.

Ada beberapa cara untuk mengkonfigurasi pengaturan ini. Mereka terdaftar di sini di
urutan prioritas (tertinggi pertama):

Garis komando Opsi
Pengaturan dapat ditentukan oleh opsi yang sesuai. Ketika sebuah pengaturan
opsi baris perintah yang sesuai disediakan, ini digunakan untuk mendukung yang lain
sarana konfigurasi. Jika GCCXML_CONFIG diatur pada baris perintah, pengaturannya adalah
baca dari file dengan prioritas hanya sedikit lebih rendah dari baris perintah lainnya
Pilihan.

Lingkungan Hidup Variabel
Pengaturan dikonfigurasi berdasarkan nama di lingkungan. Setiap pengaturan belum diketahui
dibaca dari variabel lingkungan dengan namanya. Jika GCCXML_CONFIG disetel oleh
lingkungan, pengaturan dibaca dari file dengan prioritas hanya sedikit lebih rendah
daripada variabel lingkungan lainnya.

konfigurasi File
Pencarian untuk GCCXML_CONFIG dilakukan. Jika GCCXML_CONFIG belum disetel, dan
upaya dilakukan untuk menemukan file konfigurasi secara otomatis. Pertama, jika file
$HOME/.gccxml/config ada, itu akan digunakan. Kedua, jika GCC-XML sedang dieksekusi
dari direktori build-nya, file konfigurasi dari direktori itu akan digunakan. Akhirnya,
jika file konfigurasi ditemukan di direktori perpustakaan dukungan instalasi, itu akan
digunakan. Setelah ditemukan, pengaturan yang tidak diketahui dibaca dari file konfigurasi.

Menebak
Tebakan dibuat berdasarkan pengaturan lain. Setelah GCCXML_COMPILER disetel, itu adalah
digunakan untuk menemukan setelan GCCXML_FLAGS secara otomatis. Jika tidak disetel,
Variabel lingkungan "CXX" diperiksa sebagai upaya terakhir untuk menemukan pengaturan kompiler
dan tentukan GCCXML_FLAGS.

Sebagian besar pengguna tidak perlu menyesuaikan default untuk pengaturan ini. Ada defaultnya
File GCCXML_CONFIG disediakan di direktori pustaka dukungan setelah penginstalan. Dia
mengonfigurasi GCC-XML untuk mensimulasikan kompiler yang digunakan untuk membangunnya.

KOMPILER

GCC-XML dapat mensimulasikan salah satu kompiler 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
sebelumnya didukung tetapi tidak lagi diuji

Definisi preprosesor C tambahan berikut disediakan:

-D__GCCXML__=MMmmpp
MM, mm, dan pp adalah versi mayor, minor, dan patch dari GCC-XML. Ini
simbol praprosesor mengidentifikasi GCC-XML ke kode sumber saat diproses sebelumnya.
Ini dapat digunakan untuk mengaktifkan informasi khusus GCC-XML.

-D__GCCXML_GNUC__=M
Ditetapkan untuk versi utama parser GCC internal.

-D__GCCXML_GNUC_MINOR__=m
Ditetapkan untuk versi minor parser GCC internal.

-D__GCCXML_GNUC_PATCHLEVEL__=hal
Ditetapkan ke tingkat patch parser GCC internal.

Pengguna tingkat lanjut dapat mensimulasikan kompiler lain dengan mengonfigurasi GCCXML_FLAGS secara manual
pengaturan. Hubungi milis untuk bantuan.

METAINFO

GCC-XML telah menambahkan atribut baru ke set legal atribut C/C++. Atributnya adalah
digunakan untuk melampirkan informasi meta ke kode sumber C/C++, yang kemudian akan muncul di XML
keluaran. Sintaks untuk mendeklarasikan sebuah atribut adalah sebagai berikut:

__atribut((gccxml( , , ...)))
Di Sini adalah string yang dikutip. Harus ada setidaknya satu argumen untuk
'gccxml', tetapi tidak ada batas atas jumlah total argumen.
Setiap argumen diverifikasi menjadi string - jika argumen non-string ditemukan,
atribut diabaikan.

Keluaran XML untuk elemen kode yang ditandai dengan atribut tersebut kemudian akan berisi
berikut:

atribut=" ... gccxml( , , ...) ...
Atribut XML 'atribut' berisi semua atribut yang diterapkan ke elemen kode.
Setiap argumen atribut dicetak tanpa menyertakan tanda kutip, jadi jika
argumen berisi karakter ',', argumen akan tampak berganda
argumen.

Atribut 'gccxml' dapat diterapkan ke deklarasi apa pun termasuk struct, class,
bidang, parameter, metode, fungsi, variabel, dan typedef. Satu-satunya pengecualian adalah
bahwa penanganan GCC atas elemen bahasa '__attribute' saat ini rusak untuk
enumerasi dan konstruktor dengan badan sebaris. Atribut 'gccxml' dapat digunakan
beberapa kali pada deklarasi yang diberikan.

Sebagai contoh bagaimana atribut ini dapat digunakan untuk melampirkan informasi meta ke C++
deklarasi, pertimbangkan makro berikut:

#menetapkan _keluar_ __attribute((gccxml("keluar")))
Di sini '_out_' telah didefinisikan sebagai atribut gccxml tempat argumen pertama
adalah string "keluar". Direkomendasikan bahwa argumen pertama digunakan sebagai unik
nama string untuk jenis informasi meta mulai diterapkan.

Sekarang deklarasi metode dapat ditulis sebagai berikut:

membatalkan dapatkanInteger(_keluar_ int& Saya);
Ini akan menyebabkan keluaran XML berisi informasi meta untuk '_out_'
atribut, dalam bentuk "gccxml(out)".

Menggunakan atribut 'gccxml' memungkinkan informasi meta dimasukkan langsung ke dalam C++
kode sumber, tanpa perlu pengurai khusus untuk mengekstrak informasi meta. NS
Atribut 'gccxml' disediakan hanya untuk kenyamanan - tidak ada jaminan bahwa masa depan
versi GCC akan menerima elemen bahasa '__attribute' dengan cara yang bebas bug.

HAK CIPTA

GCC-XML - keluaran XML untuk GCC

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

Redistribusi dan penggunaan dalam bentuk sumber dan biner, dengan atau tanpa modifikasi, adalah
diperbolehkan asalkan kondisi berikut terpenuhi:

* Redistribusi kode sumber harus mempertahankan pemberitahuan hak cipta di atas, daftar ini
ketentuan dan disclaimer berikut.

* Redistribusi dalam bentuk biner harus mereproduksi pemberitahuan hak cipta di atas, daftar ini
kondisi dan penafian berikut dalam dokumentasi dan/atau lainnya
bahan yang disediakan dengan distribusi.

* Baik nama Kitware, Inc., Insight Software Consortium, maupun nama
kontributor mereka dapat digunakan untuk mendukung atau mempromosikan produk yang berasal dari ini
perangkat lunak tanpa izin tertulis sebelumnya yang spesifik.

PERANGKAT LUNAK INI DISEDIAKAN OLEH PEMEGANG HAK CIPTA DAN KONTRIBUTOR "SEBAGAIMANA ADANYA" DAN SETIAP
JAMINAN TERSURAT MAUPUN TERSIRAT, TERMASUK, NAMUN TIDAK TERBATAS PADA, JAMINAN TERSIRAT DARI
DIPERDAGANGKAN DAN KESESUAIAN UNTUK TUJUAN TERTENTU DIABAIKAN. DALAM HAL APAPUN
PEMEGANG HAK CIPTA ATAU KONTRIBUTOR BERTANGGUNG JAWAB ATAS SETIAP LANGSUNG, TIDAK LANGSUNG, INSIDENTAL, KHUSUS,
KERUSAKAN CONTOH ATAU KONSEKUENSIAL (TERMASUK, NAMUN TIDAK TERBATAS PADA, PENGADAAN
BARANG ATAU JASA PENGGANTI; KEHILANGAN PENGGUNAAN, DATA, ATAU KEUNTUNGAN; ATAU GANGGUAN USAHA)
NAMUN PENYEBAB DAN TEORI TANGGUNG JAWAB APA PUN, BAIK DALAM KONTRAK, KEWAJIBAN KETAT, ATAU
TORT (TERMASUK KELALAIAN ATAU LAINNYA) YANG TIMBUL DENGAN CARA APAPUN DARI PENGGUNAAN INI
PERANGKAT LUNAK, BAHKAN JIKA DISARANKAN TENTANG KEMUNGKINAN KERUSAKAN TERSEBUT.

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

gccxml_cc1plus - Pengurai GCC yang ditambal untuk dump XML unit terjemahan

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

Program ini adalah perangkat lunak gratis; Anda dapat mendistribusikan ulang dan/atau memodifikasinya di bawah ketentuan
Lisensi Publik Umum GNU sebagaimana diterbitkan oleh Free Software Foundation; salah satu
versi 2 dari Lisensi, atau (sesuai pilihan Anda) versi yang lebih baru.

Program ini disebarluaskan dengan harapan dapat bermanfaat, namun TANPA JAMINAN APAPUN;
bahkan tanpa jaminan tersirat tentang KELAYAKAN DIPERDAGANGKAN atau KESESUAIAN UNTUK TUJUAN TERTENTU.
Lihat Lisensi Publik Umum GNU untuk lebih jelasnya.

Anda seharusnya telah menerima salinan GNU General Public License bersama dengan program ini;
jika tidak, tulis ke
Yayasan Perangkat Lunak Bebas, Inc.
51 Franklin Street, Lantai Lima
Boston, MA 02110-1301 AS

PENGIRIMAN DAFTAR

Untuk bantuan dan diskusi tentang penggunaan gccxml, milis disediakan di
[email dilindungi]. Silakan baca dulu dokumentasi lengkapnya di http://www.gccxml.org
sebelum memposting pertanyaan ke daftar.

Gunakan gccxml online menggunakan layanan onworks.net