SYNOPSIS
cc]]tiedostot…
cxx]tiedostot…
KUVAUS
Cc- ja cxx-komennot toimivat rajapintoina Microsoftin C-kääntäjälle (cl).Kääntäjän versiot 5.0 ja uudemmat tuetaan.cc on tarkoitettu C-tiedostojen kääntämiseen, kun taas cxxis on tarkoitettu C++-tiedostojen kääntämiseen.
Huomautus:
Cc:n käyttäytyminen riippuu siitä, työskenteletkö tavallisessa MKS Toolkit -kehitysympäristössä vai kehitysympäristössä, joka on suunniteltu käytettäväksi MKS Toolkit UNIX API:n kanssa.
cxx on käytettävissä vain PTC MKS Toolkit UNIX APIs -kehitysympäristössä.
Nämä komennot ovat vain kääreitä, jotka kutsuvat cl-apuohjelmaa.Jos käytät PTC MKS Toolkit for Professional Developers- tai PTC MKS Toolkit for Developers -ohjelmaa, clin PATH:n olemassaolo tarkistetaan asennuksen aikana.Muissa Toolkit-tuotteissa sinun on itse varmistettava, että clis on PATH:ssa.
Tiedostot, joissa on .c-loppuliite, ovat C-lähdetiedostoja,tiedostot, joissa on .cpp- tai .cxx-pääte, ovat C++-lähdetiedostoja ja tiedostot, joissa on .asm-pääte, ovat assembler-kielen lähdetiedostoja.Lähdetiedostojen, joissa on .cpp- tai .cxxautomaattisesti aiheuttaa sen, että lähdetiedostot käännetään ikään kuincxx-komento olisi kutsuttu sen sijaan.
Cc- ja cxx-komennot asettavat implisiittisesti seuraavat Microsoft-kääntäjäkytkimet (vain Intel-alustoille):
/D_X86_/D_NUTC_=0x430 (Value changes with each release)/Zl/Qifdiv-
Huomaa:
Vaihtoehto /D_NUTC_=0x430 asetetaan vain silloin, kun työskennellään PTC MKS Toolkit UNIX APIs -kehitysympäristössä.
Vaihtoehto /Qifdiv- asetetaan vain työskenneltäessä PTC MKS Toolkit UNIX APIs -kehitysympäristössä, ja se on käytettävissä vain Microsoft Visual Studio 2.1:ssä tai uudemmassa versiossa.
Voit käyttää -W/optionflagia välittääksesi optioita suoraan cl:lle.Varo tällöin, ettet ole ristiriidassa niiden vaihtoehtojen kanssa, jotka tämä komento asettaa. Esimerkiksi kääntäjän oletusvaroitustasoksi on asetettu/W3. Vaihtoehdolla -W/Wn voidaan ohittaa tämä oletusarvo.cl:n vaihtoehdot, jotka on määritetty komennolla -W, ohittavat muiden cc orcxx -vaihtoehtojen tuottamat cl:n vaihtoehdot.
Options
-c
kompiloi vain – ei linkitä.
Tämästä vaihtoehdosta tulee cl:n /c-vaihtoehto.
-C
päästää kommentit läpi esikäsittelijän ulostuloon.
Tämästä vaihtoehdosta tulee cl:n /C-vaihtoehto.
-Dname
määrittää esikäsittelijän symbolin valinnaisella arvolla.
Tämästä vaihtoehdosta tulee cl:n /Dname=arvo -vaihtoehto.
-E
lähettää kaiken esikäsittelijän tulosteen standarditulosteeseen.
Tämästä vaihtoehdosta tulee cl:n /E-vaihtoehto.
-e epsym
määrittää sisäänmenopisteen (välitetään linkkerille).
-ffloat
määrittää liukulukuvaihtoehdot, joita kääntäjä ja linkkeri käyttävät:
-f- no floating point required-f emulated floating point-fp hardware floating point (using 80x87 coprocessor)
Huomautus:
Tämä vaihtoehto on vanhentunut ja tuottaa varoituksen. Se tarjotaan taaksepäin yhteensopivuutta varten, eikä se ole käytettävissä cxxorilla, kun työskennellään PTC MKS Toolkit UNIX APIs -kehitysympäristössä.
-g
tuottaa virheenkorjaustietoa käännettyihin objektimoduuleihin.
Tämästä vaihtoehdosta tulee cl:n /Z7-vaihtoehto.
-I hakemisto
lisää hakemiston alkuun luetteloon hakemistoista, joista etsitään sisällyttämistiedostoja (ympäristömuuttujan %Include% arvo). Kaikki komentorivillä annetut hakemistot etsitään ensin siinä järjestyksessä kuin ne esiintyvät komentorivillä.
Tämästä vaihtoehdosta tulee cl:n /Ihakemisto-optio.
-l library
jos linkittää, lisää määritetyn kirjaston etsittävien kirjastojen luetteloon.Kirjastoja etsittäessä (esimerkiksi -lfoo:lla),jokaisesta kirjastohakemistosta etsitään ensiksi UNIX:n tyylinen arkistonimi(eli libfoo.a) ja sitten Windows-tyylinen kirjaston nimi(eli foo.lib).
Tämä valinta välitetään linkittäjälle.
-L hakemisto
jos linkitettäessä hakemisto lisätään linkittäjän etsimien kirjastojen luettelon alkuun (%Lib%ympäristömuuttujan arvo). Kaikki komentorivillä annetut hakemistot etsitään ensin siinä järjestyksessä kuin ne esiintyvät komentorivillä.
Tämä valinta välitetään linkittäjälle.
-m
tuottaa linkkikartan.
Tämä vaihtoehto välitetään linkittäjälle.
-mmodel
määrittää muistimallin, jota kääntäjä ja linkittäjä käyttävät.mallit voivat olla:
-ms small model-mm medium model-ml large model-mf flat model (32-bit)-mc compact model-mh huge model
Huomautus:
Tämä vaihtoehto on vanhentunut ja tuottaa varoituksen. Se tarjotaan taaksepäin yhteensopivuutta varten, eikä se ole käytettävissä cxxor-ohjelmalla työskenneltäessä PTC MKS Toolkit UNIX APIs -kehitysympäristössä.
-M
valittaa moninkertaisesti määritellyistä symboleista.
Huomautus:
Tämä käyttäytyminen on käytettävissä vain työskenneltäessä PTC MKS Toolkit UNIX APIs -kehitysympäristössä. Muussa tapauksessa -M on identtinen -m-vaihtoehdon kanssa.
-o output
määrittää linkittäjän tuottaman tulostiedoston nimen. Tämä optio välitetään linkittäjälle.Jos -c ja -o on molemmat määritetty, optio -o jätetään huomioimatta; voit kuitenkin määrittää nimen objektitiedostolle, joka on tuotettu komennolla -W/Foobj_file.
Huomautus:
Kun työskennellään PTC MKS Toolkit UNIX APIs -kehitysympäristössä, optiota -o ei jätetä huomioimatta. Sen sijaan se käyttäytyy kuten -W/Foobj_file ja määrittelee luodun objektitiedoston nimen.
-W/Fo -vaihtoehdolla määritetyillä tiedostonimillä tulee olla .o- tai .obj-pääte. Jos tiedostonimellä ei ole tällaista päätepistettä, sen nykyinen päätepiste korvataan .obj:llä ennen linkittäjän kutsumista. Kuitenkin, kun -cis on myös määritetty, määritetyn tiedoston tiedostopäätteelle ei ole rajoituksia.
-O
käskee kääntäjää tuottamaan optimoitua koodia.
Tämästä vaihtoehdosta tulee cl:n /Ox-optio.
-P
tallentaa esikäsittelijän tulosteet tiedostoon, jossa tiedostonimi saadaan korvaamalla .c(tai .cpp)-päätteellä .i.
-s
Linkittäessä poistetaan virheenkorjaustiedot tulostetiedostosta.
Tämä optio välitetään linkittäjälle.
-S
tuottaa assemblaatioluettelon. Listaustiedoston päätteenä on .asm. Tämä listaus sisältää lähdekoodin ja assembly-koodin.
Tämästä vaihtoehdosta tulee /FAs-vaihtoehto cl:lle.
-static
pyytää linkittämistä staattisia C++-ajokirjastoja vastaan.Tätä ei suositella.
Jos tätä vaihtoehtoa ei määritetä, /MD tocl on C++:n oletusarvo ja monisäikeiset DLL:t tuotetaan.
-u symname
Linkittäessä lisätään määrittelemätön viittaus symname:iin.
Tämä vaihtoehto välitetään linkittäjälle.
-U symname
definoi määritellyn preprocessor-symbolin.
Tästä vaihtoehdosta tulee /Usymnameoptio cl:lle.
-VS num
kulkee läpi /VERSION-linkkerioptiolle.
-Wc++
pakottaa C++-linkityksen.
Tämä optio välittyy linkittäjälle.
Huomautus:
C++-kirjastopolut ovat käytettävissä vain silloin, kun työskennellään PTC MKS Toolkit UNIX API:n kehitysympäristössä. Jos et työskentele tässä ympäristössä,sinun on määritettävä nämä kirjastopolut -L-vaihtoehdolla.
-Wv
valitsee verbose-tilan.
Tämä vaihtoehto välitetään linkittäjälle.
-W/optio
määrittää vaihtoehdon, joka välitetään joko C-kääntäjälle tai linkittäjälle, kun etumerkki -W on poistettu.Vaihtoehdot – subsystem, def,base, entry, implib,machine, map, out,stack ja dll – välitetään linkittäjälle;kaikki muut välitetään kääntäjälle.
-x
Kun linkität, poistat paikallisia symboleja koskevat virheenkorjaustiedot tulostiedostosta.
Tämä optio välitetään linkittäjälle.
-Xc
Kompiloi tiukasti ANSI C:n mukaisella tavalla.Ainoastaan ANSI C -spesifikaation määrittelemät symbolit ovat näkyvissä kääntämisen aikana.
Tämästä vaihtoehdosta tulee cl:lle vaihtoehdot /D__STRICT_ANSI=1 ja/D__STDC__=1.
-Xa -Xs -Xt
Kompiloi ei-striktillä ANSI C:n mukaisuudella. Vain ANSI C -spesifikaation määrittelemät symbolit näkyvät kääntämisen aikana.
Tästä vaihtoehdosta tulee /D__STDC__=0 tocl.
Vaikka tämä viitesivu kuvaa cc:tä Microsoftin C-kääntäjän rajapintana, se ei ole koko totuus. Todellisuudessa cc on konfiguroitava rajapinta mille tahansa C-kääntäjälle, ja se on suunniteltu käytettäväksi make:n kanssa. Teoriassa voit vain määritellä cc:n uudelleen jokaisessa järjestelmässä toimimaan kyseisen järjestelmän C-kääntäjän kanssa ja käyttämällä cc:tä make-tiedostoissasi voit käyttää samoja make-tiedostoja eri järjestelmissä.
cc käyttää kääntämisen konfigurointitiedostoa muuntamaan tavallisen komentorivin argumentit komentojen argumenteiksi, joita tarvitaan kääntäjän tai linkkerin kutsumiseen. Jos haluat vaihtaa kääntäjääsi tai linkkeriäsi, muuta sopivaa konfiguraatiotiedostoa; älä muuta makefileäsi.
Cc:n oletuskonfiguraatiotiedosto on
ROOTDIR/etc/compiler.ccg
Voit valita toisen konfiguraatiotiedoston asettamalla ympäristömuuttujan CCG osoittamaan haluamaasi tiedostoon.MKS:ltä voi olla saatavissa rajapintoja muihin kääntäjiin.
Jos haluat cc:n käyttävän tilapäisesti toista kääntäjää,voit asettaa ympäristömuuttujan CCG haluamasi kääntäjän konfiguraatiotiedoston nimeen.
Jos nimeät cc:n suoritettavan ohjelman uudelleen, se yrittää löytää oletuskonfiguraationsa .ccg-tiedostosta, jolla on sama perusnimi kuin uudelleennimetyllä suoritettavalla ohjelmalla.Jos esimerkiksi nimeät cc.exe:n uudelleen c89.exe:ksi,c89 etsii oletuskonfiguraatiotiedostoa nimeltäc89.ccg tiedostosta osoitteessa ROOTDIR/etc.
Jos käytät kääntäjää, jolla ei ole konfiguraatiotiedostoa,voit mukauttaa tietyn konfiguraatiotiedoston käyttämään omaa kääntäjääsi.Lue cc:n sekalaiset tiedot -viitesivu huolellisesti,ja muuta olemassa oleva konfiguraatio käyttämään omaa kääntäjääsi.
YMPÄRISTÖMUUTTIMET
CCG
identifioi haluamasi kääntäjän konfiguraatiotiedoston.Jos CCG:ssä on merkintä ”-”-”, cclukee oletuskonfiguraation vakiosyötteestä.Jos CCG sisältää tiedostonimen, cc käyttää kyseistä tiedostoa oletuskonfiguraatiotiedostona.Jos CCG sisältää hakemiston nimen, cc etsii oletuskonfiguraation kyseisessä hakemistossa olevasta cc.ccg-tiedostosta.Jos suoritettava tiedosto on nimetty uudelleen, se etsii oletuskonfiguraation .ccg-tiedostosta, jolla on sama nimi kuin suoritettavalla tiedostolla.Jos esimerkiksi cc.exe on nimetty uudelleen c89.exe:ksi,se etsii oletuskonfiguraation $CCG/c89.ccg-tiedostosta.
DIAGNOSTICS
Mahdolliset poistumistila-arvot ovat:
0
Suoritettu onnistuneesti loppuun.
>0
Virhe tapahtui.
Huomautus
Cc-apuohjelma, kuten monet muutkin kääntäjään liittyvät komennot, käynnistää itse asiassa asianmukaisenCCG-skriptin (katso cc:n sekalainen viitesivu) kuvattujen vaihtoehtojen esikäsittelyä varten, ennen kuin se kutsuu Microsoft-kääntäjääsuorittaakseen varsinaisen kääntämisen.Varsinainen CCG-skriptin suoritus määräytyy CCG-ympäristömuuttujan asetuksen mukaan (katsoYMPÄRISTÖMUUTTUJAT), joka voi vaihdella sen mukaan, työskenteletkö NuTCRACKER Platform -kehitysympäristössä.
Muuttaaksesi cc:tä (esimerkiksi työskennelläksesi toisen kääntäjän kanssa), sinun täytyy vain muuttaa CCG-skriptiä, joka ccrunataan CCG-ympäristömuuttujan asetuksen perusteella.
AVAILABILITY
Cc-komento on käytettävissä seuraavissa tuotteissa:
PTC MKS Toolkit for Developers
PTC MKS Toolkit for Interoperability
PTC MKS Toolkit for Professional Developers
PTC MKS Toolkit for Professional Developers 64-Bit Edition
PTC MKS Toolkit for Enterprise Developers
PTC MKS Toolkit for Enterprise Developers 64-Bit Edition
PTC Windchill Vaatimusten täyttäminen ja validointi
Cxx-komento on käytettävissä seuraavien tuotteiden kanssa:
PTC MKS Toolkit for Professional Developers
PTC MKS Toolkit for Professional Developers 64-Bit Edition
PTC MKS Toolkit for Enterprise Developers
PTC MKS Toolkit for Enterprise Developers 64-Bit Edition
KATSO MYÖS
Komennot: ld, make Sekalaiset komennot: cc
PTC MKS Toolkit 10.3 Documentation Build 39.