SYNOPSIS
cc]]files…
cxx]files…
DESCRIPTION
Příkazy cc a cxx slouží jako rozhraní pro překladač Microsoft C (cl).Podporovány jsou verze 5.0 a vyšší tohoto překladače.Příkaz cc je určen pro kompilaci souborů v jazyce C, zatímco příkaz cxx je určen pro kompilaci souborů v jazyce C++.
Poznámka:
Chování příkazu cc závisí na tom, zda pracujete ve standardním vývojovém prostředí sady MKS Toolkit nebo ve vývojovém prostředí určeném pro použití s rozhraním MKS Toolkit UNIX API.
cxx je k dispozici pouze ve vývojovém prostředí PTC MKS Toolkit UNIX API.
Tyto příkazy jsou pouze obaly, které vyvolávají utilitu c. Pokud používáte PTC MKS Toolkit for Professional Developers nebo PTC MKS Toolkit for Developers, je při instalaci kontrolována přítomnost klin PATH.U ostatních produktů sady Toolkit musíte sami zajistit, aby byl clis v PATH.
Soubory s příponou .c jsou považovány za zdrojové soubory jazyka C,soubory s příponou .cpp nebo .cxx jsou považovány za zdrojové soubory jazyka C++ a soubory s příponou .asm jsou považovány za zdrojové soubory jazyka assembler.Přítomnost zdrojových souborů s příponou .cpp nebo .cxxautomaticky způsobí, že zdrojové soubory budou zkompilovány, jako kdyby byl místo toho vyvolán příkazcxx.
Příkazy cc a cxx implicitně nastavují následující přepínače překladače Microsoft (pouze pro platformy Intel):
/D_X86_/D_NUTC_=0x430 (Value changes with each release)/Zl/Qifdiv-
Poznámka:
Volba /D_NUTC_=0x430 je nastavena pouze při práci ve vývojovém prostředí PTC MKS Toolkit UNIX API.
Příkaz /Qifdiv- je nastaven pouze při práci ve vývojovém prostředí PTC MKS Toolkit UNIX APIs a je k dispozici pouze pro Microsoft Visual Studio 2.1 nebo novější.
Příkaz -W/optionflag můžete použít k předání voleb přímo příkazu cl. Přitom dávejte pozor, aby nedošlo ke konfliktu s volbami, které tento příkaz nastavuje. Například výchozí úroveň varování kompilátoru je nastavena na/W3. Volbu -W/Wn lze použít k potlačení tohoto výchozího nastavení. volby cl zadané pomocí -W potlačují volby cl generované jinými volbami cc orcxx.
Volby
-c
pouze kompiluje – nelinkuje.
Tato volba se stává volbou /c k cl.
-C
předává komentáře na výstup preprocesoru.
Tato volba se stává volbou /C k cl.
-Dname
definuje symbol preprocesoru s volitelnou hodnotou.
Tato volba se stává volbou /Dname=hodnota k cl.
-E
odesílá veškerý výstup preprocesoru na standardní výstup.
Tato volba se stává volbou /E k cl.
-e epsym
určuje vstupní bod (předává se linkeru).
-ffloat
určuje volby plovoucí řádové čárky, které kompilátor a linker používají:
-f- no floating point required-f emulated floating point-fp hardware floating point (using 80x87 coprocessor)
Poznámka:
Tato volba je zastaralá a vyvolává varování. Je poskytována pro zpětnou kompatibilitu a není k dispozici s cxxor při práci ve vývojovém prostředí PTC MKS Toolkit UNIX APIs.
-g
produkuje ladicí informace v kompilovaných objektových modulech.
Tato volba se stává volbou /Z7 pro cl.
-I directory
přidává adresář na začátek seznamu adresářů, ve kterých se mají hledat soubory include(hodnota proměnné prostředí %Include%). Všechny adresáře zadané na příkazovém řádku jsou prohledávány jako první, v pořadí, v jakém se objevují na příkazovém řádku.
Tato volba se stává volbou /Iadresář k cl.
-l knihovna
při propojení přidá zadanou knihovnu do seznamu knihoven, které mají být prohledávány.Při vyhledávání knihoven (například pomocí -lfoo) je každý adresář knihovny nejprve prohledán podle názvu archivu ve stylu UNIXu (tj. libfoo.a) a poté na jméno knihovny ve stylu Windows(tj. foo.lib).
Tato volba je předána linkeru.
-L adresář
při linkování přidá adresář na začátek seznamu adresářů, ve kterých linker hledá knihovny (hodnota proměnné %Lib%prostředí). Všechny adresáře zadané na příkazovém řádkujsou prohledávány jako první, v pořadí, v jakém se objevují na příkazovém řádku.
Tato volba je předána linkeru.
-m
vytvoří linkovací mapu.
Tato volba je předána linkeru.
-mmodel
určuje model paměti, který kompilátor a linker používají. modely mohou zahrnovat:
-ms small model-mm medium model-ml large model-mf flat model (32-bit)-mc compact model-mh huge model
Poznámka:
Tato volba je zastaralá a vyvolá varování. Je poskytována pro zpětnou kompatibilitu a není k dispozici s cxxor při práci ve vývojovém prostředí PTC MKS Toolkit UNIX APIs.
-M
povídá o násobně definovaných symbolech.
Poznámka:
Toto chování je k dispozici pouze při práci ve vývojovém prostředí PTC MKS Toolkit UNIX APIs. Jinak je volba -M shodná s volbou -m.
-o output
určuje název výstupního souboru generovaného linkerem. Tato volba je předána linkeru. pokud jsou zadány obě volby -c a -o, volba -o je ignorována; můžete však zadat jméno proobjektového souboru generovaného pomocí -W/Foobj_file.
Poznámka:
Při práci ve vývojovém prostředí PTC MKS Toolkit UNIX APIs není volba -o ignorována. Místo toho se chová jako -W/Foobj_file a určuje název generovaného objektového souboru.
Názvy souborů zadané pomocí volby -W/Fo by měly mít příponu .o nebo .obj. Pokud název souboru takovou příponu nemá, je jeho aktuální přípona před vyvoláním linkeru nahrazena příponou .obj. Pokud je však zadána také volba -cis, nejsou na příponu zadaného souboru kladena žádná omezení.
-O
přikáže kompilátoru generovat optimalizovaný kód.
Tato volba se stává volbou /Ox pro cl.
-P
uloží výstup preprocesoru do souboru, přičemž název souboru získáte nahrazením přípony .c(nebo .cpp) příponou .i.
-s
při linkování odstraní z výstupního souboru ladicí informace.
Tato volba je předána linkeru.
-S
vyprodukuje výpis kódu assembleru. Přípona souboru s výpisem je .asm. Tento výpis obsahuje zdrojový kód a kód assembleru.
Tato volba se stává volbou /FAs pro cl.
-static
vyžaduje linkování proti statickým runtime knihovnám C++, což se nedoporučuje.
Když tato volba není zadána, je pro C++ výchozí /MD tocl a vytvářejí se vícevláknové DLL.
-u symname
při linkování přidá nedefinovanou referenci na symname.
Tato volba je předána linkeru.
-U symname
zdefinuje zadaný symbol preprocesoru.
Tato volba se stane volbou /Usymname pro cl.
-VS num
předá volbu /VERSION linkeru.
-Wc++
vynutí linkování C++.
Tato volba se předává linkeru.
Poznámka:
Cesty ke knihovnám C++ jsou k dispozici pouze při práci ve vývojovém prostředí pro PTC MKS Toolkit UNIX API. Pokud v tomto prostředí nepracujete,musíte tyto cesty ke knihovnám zadat pomocí volby -L.
-Wv
zvolí slovní režim.
Tato volba je předána linkeru.
-W/option
určuje volbu, která má být předána buď kompilátoru jazyka C, nebo linkeru s odstraněným úvodním -W. Volby – subsystem, def,base, entry, implib,machine, map, out,stack a dll – jsou předány linkeru; všechny ostatní jsou předány kompilátoru.
-x
při linkování odstraní z výstupního souboru ladicí informace týkající se lokálních symbolů.
Tato volba je předána linkeru.
-Xc
kompiluje se striktní shodou s ANSI C.Při kompilaci jsou viditelné pouze symboly specifikované specifikací ANSI C.
Tato volba se stává volbou /D__STRICT_ANSI=1 a/D__STDC__=1 pro cl.
-Xa -Xs -Xt
kompiluje s nestriktní konformitou ANSI C. Při kompilaci jsou viditelné pouze symboly specifikované specifikacíANSI C.
Tato volba se stává volbou /D__STDC__=0 tocl.
Přestože tato referenční stránka popisuje cc jako rozhraní překladače Microsoft C, není to úplná pravda. Ve skutečnosti je cc konfigurovatelné rozhraní k jakémukoli kompilátoru jazyka Ca je určeno pro použití s make. Teoreticky můžete jednoduše nadefinovat cc v každém systému tak, aby pracoval s kompilátorem C daného systému, a jednoduchým použitím cc v souborech make můžete používat stejné soubory make v různých systémech.
cc používá konfigurační soubor pro kompilaci k převodu argumentů na standardním příkazovém řádku na argumenty pro příkaz nebo posloupnost příkazů potřebných k volání vašeho kompilátoru nebo linkeru. Pokud chcete změnit svůj kompilátor nebo linker, změňte příslušný konfigurační soubor; neměňte svůj soubor makefile.
Výchozí konfigurační soubor pro cc je
ROOTDIR/etc/compiler.ccg
Můžete zvolit jiný konfigurační soubor nastavením proměnné prostředí CCG tak, aby ukazovala na požadovaný soubor. rozhraní pro jiné kompilátory mohou být k dispozici v MKS.
Pokud chcete, aby cc dočasně používal jiný kompilátor,můžete nastavit proměnnou prostředí CCGna název konfiguračního souboru pro požadovaný kompilátor.
Přejmenujete-li spustitelný soubor cc, pokusí se najít svou výchozí konfiguraci v souboru .ccg se stejným základním názvem jako přejmenovaný spustitelný soubor.například pokud přejmenujete cc.exe na c89.exe,c89 hledá výchozí konfigurační soubor s názvemc89.ccg v ROOTDIR/etc.
Používáte-li překladač, který nemá konfigurační soubor,můžete daný konfigurační soubor upravit tak, aby používal váš překladač. pozorně si přečtěte referenční stránku cc miscellaneous information a upravte existující konfiguraci tak, aby používala váš překladač.
PŘEKLADATELSKÉ PROMĚNNÉ
CCG
identifikuje konfigurační soubor pro požadovaný překladač. pokud CCG obsahuje -, cc čte výchozí konfiguraci ze standardního vstupu.Pokud CCG obsahuje název souboru, použije cc tento soubor jako výchozí konfigurační soubor. pokud CCG obsahuje název adresáře, hledá cc výchozí konfiguraci v souboru cc.ccg v tomto adresáři. pokud byl spustitelný soubor přejmenován, hledá výchozí konfiguraci v souboru .ccg se stejným názvem jako spustitelný soubor. například pokud je cc.exe přejmenován na c89.exe, hledá výchozí konfiguraci v souboru $CCG/c89.ccg.
DIAGNOSTIKA
Možné hodnoty stavu ukončení jsou:
0
Úspěšné dokončení.
>0
Došlo k chybě.
POZNÁMKA
Utilita cc, stejně jako mnoho dalších příkazů souvisejících s kompilátorem, ve skutečnosti spouští příslušný skriptCCG (viz stránka cc miscellaneous reference), který před zpracováním popsaných možností zavolá kompilátor Microsoft, aby provedl vlastní kompilaci.Skutečné spuštění skriptu CCG je určeno nastavením proměnné prostředí CCG (vizProměnné prostředí), které se může lišit v závislosti na tom, zda pracujete ve vývojovém prostředí platformy NuTCRACKER.
Chcete-li upravit cc (například pro práci s jiným kompilátorem), musíte jednoduše upravit skript CCG, který cc spustí na základě nastavení proměnné prostředí CCG.
DOSTUPNOST
Příkaz cc je k dispozici u následujících produktů:
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 Requirements and Validation
Příkaz cxx je k dispozici u následujících produktů:
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
PŘÍKAZY: ld, make Různé: cc
PTC MKS Toolkit 10.3 Dokumentace sestavení 39.
PTC MKS Toolkit 10.3 Dokumentace sestavení 39.