gccxml - Bulutta Çevrimiçi

Program:

ADI

gccxml - C++ bildirimlerinin bir XML temsilini oluşturun.

SİNOPSİS

gccxml [seçenekler] -fxml=

TANIM

GCC-XML, derleyici tarafından oluşturulduğunda görüldüğü gibi bir C++ kaynak dosyasını ayrıştırır. Kolay-
sınıf, işlev ve ad alanı bildirimlerinin ayrıştırma için XML gösterimi atılır
belirtilen bir dosyaya. Tam C ön işleme, dosyayı bir C++ çeviri birimine dönüştürür
derleyici tarafından görüldüğü gibi. Bu, GCC-XML'nin aynı standardı kullanması gerektiği anlamına gelir.
derleyici olarak kitaplık ve diğer başlık dosyaları. GCC-XML, herhangi bir simülasyonu simüle etmek için yapılandırılabilir.
birkaç popüler derleyici.

SEÇENEKLER

GCC-XML'yi çalıştırmak için aşağıdaki seçenekler mevcuttur:

--telif hakkı
GCC-XML telif hakkını yazdırın ve çıkın.

- hata ayıklama
Ek hata ayıklama bilgilerini yazdırın. Bu seçenek, GCC-XML'nin
yama uygulanmış GCC C++'ı yürütmek için kullanılan yürütülebilir ad ve komut satırı bağımsız değişkenleri
ayrıştırıcı. Bu, desteklenmeyen bir derleyiciyi simüle etmeye çalışırken kullanışlıdır.

-fxml=
XML çıktı dosyasını belirtin. Bu seçenek doğrudan yamalı GCC'ye iletilir
C++ ayrıştırıcı. XML dökümünü etkinleştirir ve çıktı dosyası adını belirtir.

-fxml-başlangıç= [,...]
Başlangıç ​​bildirimlerinin bir listesini belirtin. Bu seçenek doğrudan
yamalı GCC C++ ayrıştırıcısı. Yalnızca -fxml= belirtilmişse anlamlıdır. Bu
adlandırılmış başlangıç ​​bildirimlerinin virgülle ayrılmış bir listesini belirtir. GCC-XML dökümü yapacak
yalnızca erişilebilir olan çeviri birimindeki bildirimlerin alt kümesi
belirtilen başlangıçlardan birinden bir dizi kaynak referansı aracılığıyla
beyanları.

--gccxml-derleyici
GCCXML_COMPILER'ı "xxx" olarak ayarlayın.

--gccxml-cxxflags
GCCXML_CXXFLAGS'ı "xxx" olarak ayarlayın.

--gccxml-yürütülebilir
GCCXML_EXECUTABLE'ı "xxx" olarak ayarlayın.

--gccxml-cpp
GCCXML_CPP'yi "xxx" olarak ayarlayın.

--gccxml-config
GCCXML_CONFIG'i "xxx" olarak ayarlayın.

--gccxml-kök
GCCXML_ROOT'u "xxx" olarak ayarlayın.

--gccxml-gcc-seçenekleri
GCC seçeneklerini "xxx" dosyasından okuyun. Bu seçenek, okunacak bir dosya belirtir
yamalı GCC C++ ayrıştırıcısına geçme seçenekleri. Bu, bir
içerme dizinlerinin uzun listesi. Dosyadaki her satır bir seçenek haline gelir. Boş
'#' ile başlayan satırlar ve satırlar yok sayılır.

--yardım et Tam yardım yazdırın ve çıkın. Tam yardım, tarafından sağlanan belgelerin çoğunu görüntüler.
UNIX kılavuz sayfası. UNIX dışı platformlarda kullanım için sağlanmıştır, ancak aynı zamanda
man sayfası kurulu değilse uygundur.

--help-html
Tam yardımı HTML biçiminde yazdırın. Bu seçenek, GCC-XML yazarları tarafından yardımcı olmak için kullanılır.
web sayfaları üretir.

--adam Bir UNIX kılavuz sayfası yazdırın ve çıkın. Bu seçenek, GCC-XML yazarları tarafından
UNIX kılavuz sayfası.

--Yazdır
Yapılandırma ayarlarını yazdırın ve çıkın. GCC-XML için birçok yapılandırma seçeneği vardır.
başka bir derleyiciyi simüle etmesine yardımcı olun. Bu seçeneğin kullanılması GCC-XML'nin
kendini C++ kaynağını ayrıştıracakmış gibi yapılandır, ama dur ve yazdır
konfigürasyon bulundu. Bu, yapılandırmayı kontrol etmek için kullanışlıdır.

--önişlem
Girişi ve çıkışı önceden işleyin. GCC-XML, başka bir işlemcinin ön işlemcisini simüle eder.
derleyici. Bu seçeneği kullanmak, GCC-XML'nin kendisini sanki
C++ kaynağını ayrıştıracak, ancak ön işlemeden sonra duracak. Bu işe yarar
Diğer derleyicinin simülasyonu ile ilgili hata ayıklama sorunları.

-E --preprocess için takma ad.

--versiyon
Program adını/sürüm başlığını göster ve çık.

-I ve -D gibi diğer bayraklar, yamalı GCC C++ ayrıştırıcı yürütülebilir dosyasına iletilir.

AYARLAR

GCC-XML, C++ kaynak kodunu okurken bir derleyicinin ayrıştırıcısını simüle etmek için tasarlanmıştır. Biraz
belirli bir derleyicinin nasıl simüle edileceğini belirlemek için yapılandırma ayarları gereklidir.
kullanıcının seçimi. GCC-XML'yi yapılandırmak için aşağıdaki ayarlar kullanılabilir:

GCCXML_COMPILER
Simüle edilecek C++ derleyicisi. GCC-XML otomatik olarak belirlemeye çalışacak
bu ayar tarafından belirtilen derleyicinin nasıl simüle edileceği. derleyici belirtildi
yürütülebilir adıyla ("g++" gibi). Visual Studio için derleyici
"msvc6", "msvc7", "msvc71" veya "msvc8" ile belirtilir ("cl" verilmişse, GCC-XML
hangi VS'nin kullanılacağını tahmin etmeye çalışır).

GCCXML_CXXFLAGS
Simüle edilecek C++ derleyicisi için bayraklar. Çoğu derleyicinin davranışı,
komut satırında bayraklar belirtilerek ayarlanabilir. GCC-XML yapmaya çalıştığında
bir derleyicinin nasıl simüle edileceğini otomatik olarak belirler, bu bayraklar
dikkate.

GCCXML_CONFIG
Ortak ayarlar için yapılandırma dosyası. Varsayılan olmayan ayarlar genellikle
kullanıldığında, bunları içeren tek bir dosya yazmak uygundur. Böyle bir dosya olduğunda
belirtilen, henüz bilinmeyen herhangi bir ayarı yapılandırmak için okunacaktır. Her biri
dosyanın satırı, KEY="VALUE" biçiminde bir atamadan oluşur (örneğin,
GCCXML_COMPILER="g++").

GCCXML_EXECUTABLE
Yamalı GCC C++ ayrıştırıcı yürütülebilir dosyasını belirtin. tarafından görüldüğü gibi GCC-XML programı
kullanıcı aslında yapılandırmak için gereken bayrakları belirleyen bir ön uçtur.
başka bir derleyiciyi simüle etmek için yamalı GCC C++ ayrıştırıcısı. Bu ayar,
bayraklar belirlendikten sonra çalıştırılacak gerçek yürütülebilir dosya. Kullanıcılar nadiren
bu değeri varsayılan değerinden değiştirmeniz gerekir.

GCCXML_CPP
GCC C önişlemci yürütülebilir dosyasını belirtin. Kullanıcı tarafından görüldüğü şekliyle GCC-XML programı
aslında yamalı yapılandırmak için gereken bayrakları belirleyen bir ön uçtur.
Başka bir derleyiciyi simüle etmek için GCC C++ ayrıştırıcısı. Bu ayar,
hata ayıklama için belirlenen bayraklarla çalışacak önişlemci
amaçlar. Kullanıcıların nadiren bu değeri varsayılan değerinden değiştirmesi gerekir.

GCCXML_ROOT
GCC-XML destek kitaplığı dizini. GCC-XML yalnızca bir C++ ayrıştırıcı olduğundan,
simüle etmeye çalıştığı her derleyicinin işlevselliğini tam olarak kopyalayamaz.
Bazı derleyiciler, GCC-XML'nin doğrudan sağlayamadığı kodlu standart başlıklar sağlar.
üstesinden gelmek. Bu sınırlamaya geçici bir çözüm bulmak için, her biri için bir destek kitaplığı sağlanır.
derleyici. Bu, yerine kullanılan bir dizi başlık dosyasından oluşur.
derleyicinin sistem başlıkları. Bu dosyalar hafif ince ayarlar içerir ve ardından
karşılık gelen gerçek başlık. Bu desteği içeren dizin ağacının kökü
kitaplık üstbilgileri bu ayar tarafından belirlenir. Kullanıcıların nadiren değişmesi gerekir
bu değer varsayılanından.

GCCXML_FLAGS
Diğer derleyiciyi simüle etmek için kullanılan bayraklar. GCC-XML, yamalı GCC C++ çalıştırdığında
ayrıştırıcı, bu bayraklar programa nasıl simüle edileceğini anlatmak için iletilir.
özel derleyici. Bu ayar genellikle diğerinden otomatik olarak algılanır.
ayarlar, ancak doğrudan ileri düzey kullanıcılar tarafından belirlenebilir. Çoğu kullanıcı
bu değeri otomatik konfigürasyondan değiştirmeye çalışmayın.

GCCXML_USER_FLAGS
Derleyici simülasyonu için ek kullanıcı bayrakları. GCC-XML yamalı GCC'yi çalıştırdığında
C++ ayrıştırıcısı, bu bayraklar GCCXML_FLAGS tarafından belirtilenlere ek olarak geçirilir.
Bu, ileri düzey kullanıcıların derleyici simülasyonunu kullanmaya devam ederken
GCCXML_FLAGS otomatik yapılandırması. Kullanıcıların bunu nadiren değiştirmesi gerekir
varsayılan değerden.

Bu ayarların yapılandırılmasının birkaç yolu vardır. Burada listeleniyorlar
öncelik sırası (önce en yüksek):

Komut satırı Opsiyonlar
Ayarlar, ilgili seçenekleriyle belirlenebilir. bir ayar yapıldığında
karşılık gelen komut satırı seçeneği sağlanır, diğerlerine göre daha iyi kullanılır
yapılandırma aracı. Komut satırında GCCXML_CONFIG ayarlanmışsa, ayarlar
önceliği diğer komut satırından biraz daha düşük olan dosyadan oku
seçenekleri.

çevre Değişkenler
Ayarlar, ortamda ada göre yapılandırılır. Her ayar zaten bilinmiyor
adıyla bir ortam değişkeninden okunur. GCCXML_CONFIG tarafından ayarlanırsa
ortamda, ayarlar dosyadan biraz daha düşük öncelikli olarak okunur
diğer ortam değişkenlerinden farklıdır.

yapılandırma dosyalar
GCCXML_CONFIG için bir arama yapılır. GCCXML_CONFIG henüz ayarlanmadıysa, bir
otomatik olarak bir yapılandırma dosyası bulmaya çalışılır. İlk olarak, eğer dosya
$HOME/.gccxml/config var, kullanılacak. İkincisi, GCC-XML yürütülüyorsa
derleme dizininden, o dizinden bir yapılandırma dosyası kullanılacaktır. Nihayet,
kurulumun destek kitaplığı dizininde bir yapılandırma dosyası bulunursa,
kullanılacak. Bulunduğunda, bilinmeyen ayarlar yapılandırma dosyasından okunur.

tahmin
Tahminler diğer ayarlara göre yapılır. GCCXML_COMPILER ayarlandıktan sonra,
GCCXML_FLAGS ayarını otomatik olarak bulmak için kullanılır. ayarlanmazsa,
"CXX" ortam değişkeni, derleyici ayarını bulmak için son çare olarak kontrol edilir
ve GCCXML_FLAGS'ı belirleyin.

Çoğu kullanıcının bu ayarlar için varsayılanları ayarlaması gerekmemelidir. bir varsayılan var
Kurulumdan sonra destek kitaplığı dizininde sağlanan GCCXML_CONFIG dosyası. Bilişim Teknoloji
GCC-XML'yi, onu oluşturmak için kullanılan derleyiciyi simüle edecek şekilde yapılandırır.

derleyiciler

GCC-XML, aşağıdaki derleyicilerden herhangi birini simüle edebilir:

GCC Sürümler 4.2, 4.1, 4.0, 3.4, 3.3, 3.2, 2.95.x

Görsel C + +
Sürüm 8, 7.1, 7.0 ve 6 (sp5)

Borland, istihbarat SGI
önceden destekleniyor ancak artık test edilmiyor

Aşağıdaki ekstra C önişlemci tanımları sağlanır:

-D__GCCXML__=MMmmpp
MM, mm ve pp, GCC-XML'nin majör, minör ve yama sürümleridir. Bu
önişlemci sembolü, ön işleme tabi tutulduğu için GCC-XML'yi kaynak koduna tanımlar.
GCC-XML'ye özgü bilgileri etkinleştirmek için kullanılabilir.

-D__GCCXML_GNUC__=M
Dahili GCC ayrıştırıcı ana sürümüne tanımlandı.

-D__GCCXML_GNUC_MINOR__=m
Dahili GCC ayrıştırıcı alt sürümüne tanımlandı.

-D__GCCXML_GNUC_PATCHLEVEL__=p
Dahili GCC ayrıştırıcı yama düzeyine tanımlandı.

Gelişmiş kullanıcılar, GCCXML_FLAGS'yi manuel olarak yapılandırarak diğer derleyicileri simüle edebilir
ayar. Yardım için posta listesine başvurun.

METABİLGİ

GCC-XML, yasal C/C++ öznitelik kümesine yeni bir öznitelik ekledi. öznitelik
C/C++ kaynak koduna meta bilgileri eklemek için kullanılır, bu daha sonra XML'de görünecektir
çıktı. Bir özniteliği bildirmek için sözdizimi aşağıdaki gibidir:

__attribute((gccxml( , , ...)))
Buraya alıntı bir dizedir. için en az bir argüman olmalıdır.
'gccxml' özniteliği, ancak toplam bağımsız değişken sayısı için bir üst sınır yoktur.
Her bağımsız değişkenin bir dize olduğu doğrulanır - dize olmayan bir bağımsız değişken bulunursa,
öznitelik yoksayılır.

Öznitelikle etiketlenen kod öğesinin XML çıktısı daha sonra şunları içerecektir:
şu:

nitelikler=" ... gccxml( , , ...) ...
'Öznitelikler' XML niteliği, kod öğesine uygulanan tüm nitelikleri içerir.
Niteliğin her argümanı tırnak işaretleri olmadan yazdırılır, yani eğer bir
argüman ',' karakterini içeriyorsa, argüman birden çok gibi görünecektir
argümanlar.

'gccxml' özelliği yapılar, sınıflar,
alanlar, parametreler, yöntemler, işlevler, değişkenler ve typedef'ler. Tek istisna
GCC'nin '__attribute' dil öğesini işlemesi şu anda bozuk
satır içi gövdeli numaralandırmalar ve oluşturucular. 'gccxml' özelliği kullanılabilir
belirli bir bildirimde herhangi bir sayıda.

Bu özniteliğin C++'a meta bilgi eklemek için nasıl kullanılabileceğine bir örnek olarak
bildirimler için aşağıdaki makroyu göz önünde bulundurun:

#tanımlamak _dışarı_ __attribute((gccxml("out")))
Burada '_out_', ilk argümanın bulunduğu gccxml niteliği olarak tanımlanmıştır.
"out" dizesidir. İlk argümanın benzersiz olarak kullanılması önerilir.
Uygulanmaya başlanan meta bilgi türü için dize adı.

Şimdi bir yöntem bildirimi aşağıdaki gibi yazılabilir:

geçersiz getInteger(_out_ int& ben);
Bu, XML çıktısının '_out_' için meta bilgileri içermesine neden olur.
öznitelik, "gccxml(out)" biçiminde.

'gccxml' özelliğinin kullanılması, meta bilgilerin doğrudan C++ içine dahil edilmesini sağlar
kaynak kodu, meta bilgileri çıkarmak için özel bir ayrıştırıcıya gerek kalmadan. NS
'gccxml' özelliği yalnızca kolaylık sağlamak için sağlanmıştır - geleceğin garantisi yoktur.
GCC sürümleri, '__attribute' dil öğesini hatasız bir şekilde kabul edecektir.

TELİF HAKKI

GCC-XML - GCC için XML çıktısı

Telif Hakkı 2002-2012 Kitware, Inc., Insight Consortium

Değiştirilerek veya değiştirilmeden kaynak ve ikili biçimlerde yeniden dağıtım ve kullanım,
aşağıdaki koşulların karşılanması koşuluyla izin verilir:

* Kaynak kodunun yeniden dağıtımları, yukarıdaki telif hakkı bildirimini korumalıdır, bu liste
koşullar ve aşağıdaki sorumluluk reddi.

* İkili biçimde yeniden dağıtımlar, yukarıdaki telif hakkı bildirimini yeniden üretmelidir, bu liste
belgelerde ve/veya diğer durumlarda koşulların ve aşağıdaki sorumluluk reddinin
Dağıtımla sağlanan malzemeler.

* Kitware, Inc., Insight Software Consortium adları veya adları
katkıda bulunanlar, bundan türetilen ürünleri desteklemek veya tanıtmak için kullanılabilir.
önceden yazılı izin alınmadan yazılım.

BU YAZILIM, TELİF HAKKI SAHİPLERİ VE KATILIMCILAR TARAFINDAN "OLDUĞU GİBİ" VE HERHANGİ BİR
GARANTİLERİ DAHİL ANCAK BUNLARLA SINIRLI OLMAYAN AÇIK VEYA ZIMNİ GARANTİLER
SATILABİLİRLİK VE BELİRLİ BİR AMACA UYGUNLUK REDDEDİLMİŞTİR. HİÇBİR DURUMDA
TELİF HAKKI SAHİBİ VEYA KATKIDA BULUNANLAR DOĞRUDAN, DOLAYLI, ARIZİ, ÖZEL,
ÖRNEK VEYA DOLAYLI HASARLAR (HASARLAR DAHİL, ANCAK BUNLARLA SINIRLI OLMAMAKTADIR,
İKAME MAL VEYA HİZMETLER; KULLANIM, VERİ VEYA KAR KAYBI; VEYA İŞ KESİNTİSİ)
NEDEN OLURSA OLSUN VE HERHANGİ BİR SORUMLULUK TEORİSİNE GÖRE, SÖZLEŞMEDE, KISIT SORUMLULUK VEYA
HERHANGİ BİR ŞEKİLDE BUNUN KULLANIMINDAN KAYNAKLANAN HAKSIZ FİİL (İHMAL VEYA BAŞKA BİR ŞEKİLDE)
YAZILIM, BÖYLE HASAR OLASILIĞI TAVSİYE EDİLSE BİLE.

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

gccxml_cc1plus - Çeviri birimlerinin XML dökümleri için yamalı bir GCC ayrıştırıcısı

Telif Hakkı 2002-2012 Kitware, Inc., Insight Consortium

Bu program ücretsiz bir yazılımdır; yeniden dağıtabilir ve/veya şartlarına göre değiştirebilirsiniz.
Özgür Yazılım Vakfı tarafından yayınlanan GNU Genel Kamu Lisansı; herhangi biri
Lisansın 2. sürümü veya (isteğe bağlı olarak) daha sonraki herhangi bir sürüm.

Bu program faydalı olması ümidiyle dağıtılmaktadır, ancak HİÇBİR GARANTİ YOKTUR;
SATILABİLİRLİK veya BELİRLİ BİR AMACA UYGUNLUK zımni garantisi bile olmadan.
Daha fazla ayrıntı için GNU Genel Kamu Lisansına bakın.

Bu programla birlikte GNU Genel Kamu Lisansının bir kopyasını almış olmalısınız;
değilse, şuraya yazın
Özgür Yazılım Vakfı, Inc.
51 Franklin Caddesi, Beşinci Kat
Boston, MA 02110-1301 ABD

POSTA LİSTESİ

gccxml kullanımıyla ilgili yardım ve tartışma için şu adreste bir posta listesi verilmiştir:
[e-posta korumalı]. Lütfen önce tüm belgeleri şu adresten okuyun: http://www.gccxml.org
listeye soru göndermeden önce.

onworks.net hizmetlerini kullanarak gccxml'i çevrimiçi kullanın