CL úkolu
Zalomí nástroj kompilátoru Visual C++ cl.exe.Kompilátor vytvoří spustitelné soubory (EXE), soubory knihovny (DLL) nebo modulu kódu (.soubory netmodule).Další informace naleznete v tématu Možnosti kompilátoru.
Parametry
Následující tabulka popisuje parametry CL úkolu.Většina úloh parametrů a několik sad parametrů, odpovídají možnost příkazového řádku.
Parametr |
Description |
|---|---|
AdditionalIncludeDirectories |
Nepovinný řetězcový parametr []. Přidá do seznamu adresářů, které jsou vyhledávány soubory zahrnutí adresář. Další informace naleznete v tématu /I (Další adresáře obsahují). |
AdditionalOptions |
Volitelný parametr řetězec. Seznam možností příkazového řádku.Například "/možnost /option2 /možnost #".Pomocí tohoto parametru lze určit možnosti příkazového řádku, které není reprezentován jiných úloh parametrů. Další informace naleznete v tématu Možnosti kompilátoru. |
AdditionalUsingDirectories |
Nepovinný řetězcový parametr []. Určuje adresář, který kompilátor bude hledat řešení předán soubor odkazů #using směrnice. Další informace naleznete v tématu /AI (zadat metadat adresáře). |
AlwaysAppend |
Volitelný parametr řetězec. Řetězec to vždy získává emitovány v příkazovém řádku.Jeho výchozí hodnota je "/c". |
AssemblerListingLocation |
Vytvoří soubor výpis, který obsahuje kód pro sestavení. Další informace naleznete /Fa volbu v / DM, /Fa (soubor výpisu). |
AssemblerOutput |
Volitelný parametr řetězec. Vytvoří soubor výpis, který obsahuje kód pro sestavení. Zadejte jednu z následujících hodnot, z nichž každé odpovídá parametru příkazového řádku.
ValueMožnosti příkazového řádku:
NoListing<none>
AssemblyCode/FA
AssemblyAndMachineCode/FAc
AssemblyAndSourceCode/FAs
All/FAcs
For more information, see the /FA, /FAc, /FAs, and /FAcs options in / DM, /Fa (soubor výpisu). |
BasicRuntimeChecks |
Volitelný parametr řetězec. Povolí nebo zakáže funkci kontroly Chyba spuštění společně s runtime_checks pragma. Zadejte jednu z následujících hodnot, z nichž každé odpovídá parametru příkazového řádku.
ValueMožnosti příkazového řádku:
Default<none>
StackFrameRuntimeCheck/RTCs
UninitializedLocalUsageCheck/RTCu
EnableFastChecks/RTC1
Další informace naleznete v tématu / RTC (Chyba při spuštění kontroly). |
BrowseInformation |
Volitelný parametr Boolean. Pokud true, vytvoří soubor informací o procházení. Další informace naleznete /FR volbu v / FR, /Fr (vytvořit.Soubor spectral). |
BrowseInformationFile |
Volitelný parametr řetězec. Určuje název souboru pro soubor procházení. Další informace naleznete BrowseInformation v této tabulce a také viz parametr / FR, /Fr (vytvořit.Soubor spectral). |
BufferSecurityCheck |
Volitelný parametr Boolean. Pokud true, rozpozná některé chyby přetečení vyrovnávací paměti, které přepisují zpáteční adresu technika společného využívání kód, který nevynucuje omezení velikosti vyrovnávací paměti. Další informace naleznete v tématu /GS (Kontrola zabezpečení vyrovnávací paměti). |
BuildingInIDE |
Volitelný parametr Boolean. Pokud true, že MSBuild je vyvolán IDE.Jinak MSBuild je uplatňována na příkazovém řádku. |
CallingConvention |
Volitelný parametr řetězec. Určuje konvence volání, které určuje pořadí, v jaké funkci argumenty se posunou do zásobníku, zda funkce volající nebo volaný funkce odebere argumenty ze zásobníku na konci volání a úmluvy stavební dokončovací práce název, který kompilátor používá k identifikaci jednotlivých funkcí. Zadejte jednu z následujících hodnot, z nichž každé odpovídá parametru příkazového řádku.
ValueMožnosti příkazového řádku:
Cdecl/Gd
FastCall/Gr
StdCall/Gz
Další informace naleznete v tématu / Gd, parametry kompilátoru /Gr, /Gz (volací úmluva). |
CompileAs |
Volitelný parametr řetězec. Určuje, zda kompilaci vstupní soubor jako zdrojový soubor c nebo C++. Zadejte jednu z následujících hodnot, z nichž každé odpovídá parametru příkazového řádku.
ValueMožnosti příkazového řádku:
Default<none>
CompileAsC/TC
CompileAsCpp/TP
Další informace naleznete v tématu / Tc /TP /Tp /TC, (určete typ zdrojového souboru). |
CompileAsManaged |
Volitelný parametr řetězec. Umožňuje aplikací a komponent využít funkcí společného jazykového modulu runtime (CLR). Zadejte jednu z následujících hodnot, z nichž každé odpovídá parametru příkazového řádku.
ValueMožnosti příkazového řádku:
false<none>
true/clr
Pure/clr:pure
Safe/clr:safe
OldSyntax/clr:oldSyntax
Další informace naleznete v tématu /CLR (kompilace společné Language Runtime). |
CreateHotpatchableImage |
Volitelný parametr Boolean. Pokud true, připravte obraz pro kompilátoru sděluje technologie hot patching.Tento parametr zajišťuje, že první instrukce každé funkci dvou bajtů, které je požadováno pro technologie hot patching. Další informace naleznete v tématu /hotpatch (vytvořit obraz Hotpatchable). |
DebugInformationFormat |
Volitelný parametr řetězec. Vybere typ ladicí informace pro program a zda tyto informace jsou uchovávány v objektu (obj) soubory nebo v databázi programu (PDB). Zadejte jednu z následujících hodnot, z nichž každé odpovídá parametru příkazového řádku.
ValueMožnosti příkazového řádku:
OldStyle/Z7
ProgramDatabase/Zi
EditAndContinue/ZI
Další informace naleznete v tématu / Z7, /Zi, /ZI (informace o ladění formát). |
DisableLanguageExtensions |
Volitelný parametr Boolean. Pokud true, říká kompilátoru posílat chybové konstrukce jazyka, které nejsou kompatibilní s ANSI C nebo ANSI C++. Další informace naleznete /Za volbu v / Za, /Ze (jazyk zakázat rozšíření). |
DisableSpecificWarnings |
Nepovinný řetězcový parametr []. Zakáže upozornění čísel, které jsou uvedeny v seznamu oddělený středníkem. Další informace naleznete /wd volbu v /w, /Wn, /WX, /Wall, /wln, /wdn, /wen, / won (úroveň upozornění). |
EnableEnhancedInstructionSet |
Volitelný parametr řetězec. Určuje architekturu pro generování kódu, který používá Streaming SIMD Extensions (SSE) a pokyny pro Streaming SIMD Extensions 2 (SSE2). Zadejte jednu z následujících hodnot, z nichž každé odpovídá parametru příkazového řádku.
ValueMožnosti příkazového řádku:
StreamingSIMDExtensions/arch:SSE
StreamingSIMDExtensions2/arch:SSE2
Další informace naleznete v tématu /arch (x86). |
EnableFiberSafeOptimizations |
Volitelný parametr Boolean. Pokud true, podpora fiber bezpečnosti dat pomocí statický podproces místní úložiště, dat pomocí přidělených přidělené __declspec(thread). Další informace naleznete v tématu /GT (podpora bezpečné Fiber podproces místní úložiště). |
EnablePREfast |
Volitelný parametr Boolean. Pokud true, analýzu kódu. Další informace naleznete v tématu /analyze (Analýza kódu). |
ErrorReporting |
Volitelný parametr řetězec. Umožňuje poskytnout informace kompilátoru chybu (LED) přímo do společnosti Microsoft.Ve výchozím nastavení v sestavení IDE je Prompt a nastavení v sestavení příkazového řádku je Queue. Zadejte jednu z následujících hodnot, z nichž každé odpovídá parametru příkazového řádku.
ValueMožnosti příkazového řádku:
None/errorReport:none
Prompt/errorReport:prompt
Queue/errorReport:queue
Send/errorReport:send
Další informace naleznete v tématu /errorReport (sestava interní chyby kompilátoru). |
ExceptionHandling |
Volitelný parametr řetězec. Určuje model používaný kompilátor zpracování výjimek. Zadejte jednu z následujících hodnot, z nichž každé odpovídá parametru příkazového řádku.
ValueMožnosti příkazového řádku:
false<none>
Async/EHa
Sync/EHsc
SyncCThrow/EHs
Další informace naleznete v tématu /EH (Model zpracování výjimek). |
ExpandAttributedSource |
Volitelný parametr Boolean. Pokud true, vytvoří soubor výpisu, který má rozšířené atributy vstříknutého do zdrojového souboru. Další informace naleznete v tématu /FX (sloučit vloženého kódu). |
FavorSizeOrSpeed |
Volitelný parametr řetězec. Určuje, zda upřednostnit rychlost velikost nebo kód kód. Zadejte jednu z následujících hodnot, z nichž každé odpovídá parametru příkazového řádku.
ValueMožnosti příkazového řádku:
Neither<none>
Size/Os
Speed/Ot
Další informace naleznete v tématu / Os, /Ot (kód malé něco pro tuhle, něco pro tuhle rychlé kód). |
FloatingPointExceptions |
Volitelný parametr Boolean. Pokud true, umožňuje spolehlivé čárce výjimku modelu.Výjimky bude aktivována ihned po jejich aktivaci. Další informace naleznete /fp:except volbu v /FP (určit chování s plovoucí čárkou). |
FloatingPointModel |
Volitelný parametr řetězec. Nastaví plovoucí bod modelu. Zadejte jednu z následujících hodnot, z nichž každé odpovídá parametru příkazového řádku.
ValueMožnosti příkazového řádku:
Precise/fp:precise
Strict/fp:strict
Fast/fp:fast
Další informace naleznete v tématu /FP (určit chování s plovoucí čárkou). |
ForceConformanceInForLoopScope |
Volitelný parametr Boolean. Pokud true, implementuje standardní chování jazyka C++ v pro smyčky, které používají rozšíření Microsoft (/Ze). Další informace naleznete v tématu /Zc:forScope (platnost shodu v oboru smyčky). |
ForcedIncludeFiles |
Volitelný String[] parametr. Způsobí předprocesoru zpracovat jeden nebo více souborů zadané záhlaví. Další informace naleznete v tématu /Fi (název vynucené zahrnout soubor). |
ForcedUsingFiles |
Volitelný String[] parametr. Způsobuje preprocesoru procesu, jeden nebo více zadaných #using soubory. Další informace naleznete v tématu /FU (název vynucené # pomocí souboru). |
FunctionLevelLinking |
Volitelný Boolean parametr. Pokud true, umožňuje kompilátoru jednotlivých funkcí balíčku ve formě balených funkce (COMDATs). Další informace naleznete v tématu /Gy (Povolit funkce úrovně propojení). |
GenerateXMLDocumentationFiles |
Volitelný Boolean parametr. Pokud true, způsobí, že kompilátor zpracovat dokumentaci komentáře do zdrojového kódu, soubory a vytvořte soubor .xdc pro každý soubor zdrojový kód, který má komentáře k dokumentaci. Další informace naleznete v tématu /DOC (komentáře dokumentaci procesu) (C/C++).Viz také XMLDocumentationFileName parametr v této tabulce. |
IgnoreStandardIncludePath |
Volitelný Boolean parametr. Pokud true, zabraňuje kompilátor hledání zahrnout soubory v adresářích zadané v proměnné prostředí PATH a zahrnout. Další informace naleznete v tématu /X (ignorovat standardní zahrnout cesty). |
InlineFunctionExpansion |
Volitelný String parametr. Určuje úroveň vložené rozšiřující funkce pro sestavení. Zadejte jednu z následujících hodnot, z nichž každé odpovídá parametru příkazového řádku.
ValueMožnosti příkazového řádku:
Default<none>
Disabled/Ob0
OnlyExplicitInline/Ob1
AnySuitable/Ob2
Další informace naleznete v tématu /Ob (vložené funkce rozšíření). |
IntrinsicFunctions |
Volitelný Boolean parametr. Pokud true, nahradí některé funkce volání s vnitřní nebo jinak zvláštní formy funkce, které pomáhají aplikace rychleji. Další informace naleznete v tématu /OI (generování vnitřní funkce). |
MinimalRebuild |
Volitelný Boolean parametr. Pokud true, povoluje se minimální sestavení, která určuje, zda C++ zdrojové soubory, které zahrnují změněné C++ třídy definice (uložené v souborech záhlaví (soubor s příponou h)) musí být provedena nová kompilace. Další informace naleznete v tématu /GM (povolit minimální sestavení). |
MultiProcessorCompilation |
Volitelný Boolean parametr. Pokud true, kompilace pomocí více procesorů.Tento parametr vytvoří proces pro každý procesor účinné v počítači. Další informace naleznete v tématu /MP (sestavení s více procesy).Další informace naleznete ProcessorNumber parametr v této tabulce. |
ObjectFileName |
Volitelný String parametr. Určuje název objektu (obj) soubor nebo adresář použit výchozí. Další informace naleznete v tématu /FO (název souboru objektu). |
ObjectFiles |
Volitelný String[] parametr. Seznam souborů, objektů. |
OmitDefaultLibName |
Volitelný Boolean parametr. Pokud true, vynechá výchozí název C Runtime library ze souboru objektu (obj).Standardně kompilátor vloží název knihovny do souboru obj přímého linker správné knihovny. Další informace naleznete v tématu /Zl (vynechat výchozí název knihovny). |
OmitFramePointers |
Volitelný Boolean parametr. Pokud true, potlačí vytvoření rámce ukazatelů na zásobník volání. Další informace naleznete v tématu /Oy (vynechání snímků ukazatel). |
OpenMPSupport |
Volitelný Boolean parametr. Pokud true, způsobí, že kompilátor zpracovat klauzule OpenMP a směrnic. Další informace naleznete v tématu /openmp (Povolit OpenMP 2.0 podpora). |
Optimization |
Volitelný String parametr. Určuje různé optimalizace kódu pro rychlost a velikost. Zadejte jednu z následujících hodnot, z nichž každé odpovídá parametru příkazového řádku.
ValueMožnosti příkazového řádku:
Disabled/Od
MinSpace/O1
MaxSpeed/O2
Full/Ox
Další informace naleznete v tématu /O možnosti (Optimalizace kódu). |
PrecompiledHeader |
Volitelný String parametr. Vytvořit nebo použít soubor předkompilovaný záhlaví (.pch) během sestavení. Zadejte jednu z následujících hodnot, z nichž každé odpovídá parametru příkazového řádku.
ValueMožnosti příkazového řádku:
NotUsing<none>
Create/Yc
Use/Yu
Další informace naleznete v tématu /Yc (vytvořit soubor předkompilovaný záhlaví) a /YU (použití kompilovaných hlavičky souboru).Další informace naleznete PrecompiledHeaderFile a PrecompiledHeaderOutputFile parametry v této tabulce. |
PrecompiledHeaderFile |
Volitelný String parametr. Určuje název souboru předkompilovaný záhlaví vytvořit nebo použít. Další informace naleznete v tématu /Yc (vytvořit soubor předkompilovaný záhlaví) a /YU (použití kompilovaných hlavičky souboru). |
PrecompiledHeaderOutputFile |
Volitelný String parametr. Určuje název cesty pro předkompilovaný záhlaví namísto výchozí název cesty. Další informace naleznete v tématu /FP (název.Soubor pch). |
PreprocessKeepComments |
Volitelný Boolean parametr. Pokud true, zachová komentáře při úpravě před zpracováním. Další informace naleznete v tématu /C (při úpravě před zpracováním zachovat komentáře). |
PreprocessorDefinitions |
Volitelný String[] parametr. Definuje předzpracování symbol pro zdrojový soubor. Další informace naleznete v tématu /D (definice preprocesoru). |
PreprocessOutput |
Volitelný ITaskItem[] parametr. Definuje pole položek výstup preprocesoru, které mohou být spotřebovány a vyzařovaného úkoly. |
PreprocessOutputPath |
Volitelný String parametr. Určuje název výstupního souboru, do kterého PreprocessToFile parametr zapíše výstup předem zpracovaný kód. Další informace naleznete v tématu /Fi (Poznámka, auto matický název výstupního souboru). |
PreprocessSuppressLineNumbers |
Volitelný Boolean parametr. Pokud true, C a C++ zdrojové soubory znovu a zkopíruje soubory předem zpracovaný kód standardní výstupní zařízení. Další informace naleznete v tématu /EP (Preprocess bez #line směrnic STDOUT). |
PreprocessToFile |
Volitelný Boolean parametr. Pokud true, C a C++ zdrojové soubory znovu a zapíše výstup předem zpracovaný kód do souboru. Další informace naleznete v tématu /P (Poznámka, Auto matický do souboru). |
ProcessorNumber |
Volitelný Integer parametr. Určuje maximální počet procesorů použít ve víceprocesorových kompilace.Tento parametr lze použít v kombinaci s MultiProcessorCompilation parametr. |
ProgramDataBaseFileName |
Volitelný String parametr. Určuje název souboru pro soubor databáze (PDB) programu. Další informace naleznete v tématu /FD (název souboru databáze programu). |
RuntimeLibrary |
Volitelný String parametr. Označuje, zda je knihovna DLL modulu s více podprocesy a vybere maloobchodní nebo ladění verzí knihovny runtime. Zadejte jednu z následujících hodnot, z nichž každé odpovídá parametru příkazového řádku.
ValueMožnosti příkazového řádku:
MultiThreaded/MT
MultiThreadedDebug/MTd
MultiThreadedDLL/MD
MultiThreadedDebugDLL/MDd
Další informace naleznete v tématu / /LD MD, /MT, (použití knihovna Run-Time). |
RuntimeTypeInfo |
Volitelný Boolean parametr. Pokud true, přidá kód kontrolovat typy objektů jazyka C++ v době spuštění (typu runtime informace). Další informace naleznete v tématu Parametry kompilátoru /GR (informace o typu v době spuštění povolit). |
ShowIncludes |
Volitelný Boolean parametr. Pokud true, způsobí v kompilátoru, výstup seznam souborů zahrnout. Další informace naleznete v tématu /showIncludes (seznamu zahrnout soubory). |
SmallerTypeCheck |
Volitelný Boolean parametr. Pokud true, pokud je přiřazen k typu menší hodnotu a způsobuje ztrátu dat hlásí chybu běhu. Další informace naleznete /RTCc volbu v / RTC (Chyba při spuštění kontroly). |
Sources |
Požadované ITaskItem[] parametr. Určuje seznam zdrojových souborů oddělených mezerami. |
StringPooling |
Volitelný Boolean parametr. Pokud true, umožňuje vytvořit jednu kopii shodné řetězce v bitové kopii programu kompilátoru. Další informace naleznete v tématu /GF (odstranění řetězců duplikátu). |
StructMemberAlignment |
Volitelný String parametr. Určuje zarovnání bajt pro všechny členy ve struktuře. Zadejte jednu z následujících hodnot, z nichž každé odpovídá parametru příkazového řádku.
ValueMožnosti příkazového řádku:
Default/Zp1
1Byte/Zp1
2Bytes/Zp2
4Bytes/Zp4
8Bytes/Zp8
16Bytes/Zp16
Další informace naleznete v tématu /ZP (Struct členské zarovnání). |
SuppressStartupBanner |
Volitelný Boolean parametr. Pokud true, zabraňuje zobrazení autorských právech a verzi číslo zprávy po spuštění úlohy. Další informace naleznete v tématu nologo (potlačí spuštění hlavičky) (C/C++). |
TrackerLogDirectory |
Volitelný String parametr. Určuje dílčí adresář, kde jsou uloženy protokoly sledování pro tento úkol. Další informace naleznete TLogReadFiles a TLogWriteFiles parametry v této tabulce. |
TreatSpecificWarningsAsErrors |
Volitelný String[] parametr. Zadaný seznam upozornění kompilátoru považovány za chyby. Další informace naleznete /wen volbu v /w, /Wn, /WX, /Wall, /wln, /wdn, /wen, / won (úroveň upozornění). |
TreatWarningAsError |
Volitelný Boolean parametr. Pokud true, považovat všechna upozornění kompilátoru chyby. Další informace naleznete v /WX volbu v /w, /Wn, /WX, /Wall, /wln, /wdn, /wen, / won (úroveň upozornění). |
TreatWChar_tAsBuiltInType |
Volitelný Boolean parametr. Pokud true, zachází wchar_t jako nativní typ typu. Další informace naleznete v tématu /Zc:wchar_t (wchar_t je nativní typ). |
UndefineAllPreprocessorDefinitions |
Volitelný Boolean parametr. Pokud true, undefines Microsoft zvláštní symboly, které definuje kompilátoru. Další informace naleznete /u volbu v / U, /u (nedefinovaný symboly). |
UndefinePreprocessorDefinitions |
Volitelný String[] parametr. Určuje seznam preprocesoru symboly nedefinovaný. Další informace naleznete v /U volbu v / U, /u (nedefinovaný symboly). |
UseFullPaths |
Volitelný Boolean parametr. Pokud true, zobrazí se úplná cesta souborů zdrojového kódu předán kompilátoru v Diagnostika. Další informace naleznete v tématu /FC (úplnou cestu souboru zdrojový kód v Diagnostika). |
UseUnicodeForAssemblerListing |
Volitelný Boolean parametr. Pokud true, způsobuje výstupní soubor, který má být vytvořen ve formátu UTF-8. Další informace naleznete /FAu volbu v / DM, /Fa (soubor výpisu). |
WarningLevel |
Volitelný String parametr. Určuje nejvyšší úroveň upozornění, který je generován kompilátorem. Zadejte jednu z následujících hodnot, z nichž každé odpovídá parametru příkazového řádku.
ValueMožnosti příkazového řádku:
TurnOffAllWarnings/W0
Level1/W1
Level2/W2
Level3/W3
Level4/W4
EnableAllWarnings/Wall
Další informace naleznete /Wn volbu v /w, /Wn, /WX, /Wall, /wln, /wdn, /wen, / won (úroveň upozornění). |
WholeProgramOptimization |
Volitelný Boolean parametr. Pokud true, umožňuje optimalizaci celého programu. Další informace naleznete v tématu /GL (celý Program optimalizace). |
XMLDocumentationFileName |
Volitelný String parametr. Určuje název generované soubory dokumentace XML.Tento parametr může být název souboru nebo adresáře. Další informace naleznete name argument v /DOC (komentáře dokumentaci procesu) (C/C++).Viz také GenerateXMLDocumentationFiles parametr v této tabulce. |
MinimalRebuildFromTracking |
Volitelný Boolean parametr. Pokud true, je provedena sledované přírůstkového sestavení; Pokud false, se provádí sestavení. |
TLogReadFiles |
Volitelný ITaskItem[] parametr. Určuje pole položek, které představují Číst soubor protokoly sledování. Sledování číst soubor protokolu (.tlog) obsahuje názvy vstupní soubory čtení úkolu a používá systém sestavení projektu k podpoře přírůstkového sestavení.Další informace naleznete TrackerLogDirectory a TrackFileAccess parametry v této tabulce. |
TLogWriteFiles |
Volitelný ITaskItem[] parametr. Určuje pole položek, které představují zápis souboru sledování protokolů. Zápis souboru protokolu sledování (.tlog) obsahuje názvy výstupních souborů, které jsou zapsána úkolu a používá systém sestavení projektu k podpoře přírůstkového sestavení.Další informace naleznete TrackerLogDirectory a TrackFileAccess parametry v této tabulce. |
TrackFileAccess |
Volitelný Boolean parametr. Pokud true, sleduje vzorky souboru přístup. Další informace naleznete TLogReadFiles a TLogWriteFiles parametry v této tabulce. |