Sdílet prostřednictvím

CL – úloha

  • Článek

Poznámka:

Tato úloha je k dispozici pouze při použití systému sestavení jazyka C++.

Zabalí nástroj kompilátoru Jazyka C++ cl.exe. Kompilátor vytváří spustitelné soubory (.exe), soubory dynamické knihovny (.dll) nebo soubory modulu kódu (.netmodule). Další informace naleznete v tématu Možnosti kompilátoru a Použití nástroje MSBuild z příkazového řádku a Použití sady nástrojů Microsoft C++ z příkazového řádku.

Parametry

Následující seznam popisuje parametry úlohy CL . Většina parametrů úkolu a několik sad parametrů odpovídá možnosti příkazového řádku.

  • AdditionalIncludeDirectories

    Volitelný parametr String[]

    Přidá adresář do seznamu adresářů, které se hledají v zahrnutí souborů.

    Další informace naleznete v tématu /I (další adresáře zahrnutí).

  • AdditionalOptions

    Volitelný parametr String.

    Seznam možností příkazového řádku Například /<option1> /<option2> /<option#>. Tento parametr použijte k určení možností příkazového řádku, které nejsou reprezentovány žádným jiným parametrem úkolu.

    Další informace naleznete v tématu Možnosti kompilátoru.

  • AdditionalUsingDirectories

    Volitelný parametr String[]

    Určuje adresář, který kompilátor vyhledá, aby přeložil odkazy na soubory předané direktivě #using .

    Další informace najdete v tématu /AI (určení adresářů metadat).

  • AlwaysAppend

    Volitelný parametr String.

    Řetězec, který se vždy vygeneruje na příkazovém řádku. Výchozí hodnota je /c.

  • AssemblerListingLocation

    Vytvoří soubor výpisu, který obsahuje kód sestavení.

    Další informace najdete v části /Fa v /FA, /Fa (soubor výpisu).

  • AssemblerOutput

    Volitelný parametr String.

    Vytvoří soubor výpisu, který obsahuje kód sestavení.

    Zadejte jednu z následujících hodnot, z nichž každá odpovídá možnosti příkazového řádku.

    • NoListing - <none>

    • AssemblyCode - /FA

    • AssemblyAndMachineCode - /FAc

    • AssemblyAndSourceCode - /FAs

    • Vše - /FAcs

      Další informace najdete v možnostech /FA, /FAc, /FAs a /FAcs v /FA, /Fa (soubor výpisu).

  • BasicRuntimeChecks

    Volitelný parametr String.

    Povolí a zakáže funkci kontrol chyb za běhu ve spojení s runtime_checks direktivou pragma.

    Zadejte jednu z následujících hodnot, z nichž každá odpovídá možnosti příkazového řádku.

    • Výchozí - <žádný>

    • StackFrameRuntimeCheck - /RTCs

    • NeinicializovanéLocalUsageCheck - /RTCu

    • EnableFastChecks - /RTC1

      Další informace najdete v tématu /RTC (kontroly chyb za běhu).

  • BrowseInformation

    Volitelný logický parametr.

    Pokud truevytvoří soubor s informacemi o procházení.

    Další informace naleznete v části /FR , /Fr (vytvoření souboru .sbr).

  • BrowseInformationFile

    Volitelný parametr String.

    Určuje název souboru pro soubor s informacemi o procházení.

    Další informace naleznete v parametru BrowseInformation v této tabulce a také viz /FR, /Fr (vytvoření souboru .sbr).

  • BufferSecurityCheck

    Volitelný logický parametr.

    Pokud truezjistí některá přetečení vyrovnávací paměti, která přepíše zpáteční adresu, běžnou technikou zneužití kódu, který nevynucuje omezení velikosti vyrovnávací paměti.

    Další informace najdete v tématu /GS (kontrola zabezpečení vyrovnávací paměti).

  • BuildingInIDE

    Volitelný logický parametr.

    Pokud trueoznačuje, že nástroj MSBuild je vyvolán integrovaným vývojovém prostředím (IDE). V opačném případě se nástroj MSBuild vyvolá na příkazovém řádku.

  • CallConvention

    Volitelný parametr String.

    Určuje konvenci volání, která určuje pořadí, ve kterém jsou argumenty funkce vloženy do zásobníku, zda volající funkce nebo volané funkce odebere argumenty ze zásobníku na konci volání, a konvenci dekódování názvů, kterou kompilátor používá k identifikaci jednotlivých funkcí.

    Zadejte jednu z následujících hodnot, z nichž každá odpovídá možnosti příkazového řádku.

  • Kompilace

    Volitelný parametr String.

    Určuje, zda se má vstupní soubor zkompilovat jako zdrojový soubor jazyka C nebo C++.

    Zadejte jednu z následujících hodnot, z nichž každá odpovídá možnosti příkazového řádku.

  • CompileAsManaged

    Volitelný parametr String.

    Umožňuje aplikacím a komponentám používat funkce z modulu CLR (Common Language Runtime).

    Zadejte jednu z následujících hodnot, z nichž každá odpovídá možnosti příkazového řádku.

  • CreateHotpatchableImage

    Volitelný logický parametr.

    Pokud truekompilátoru řekne, aby připravil image na horké opravy. Tento parametr zajišťuje, že první instrukce každé funkce je dva bajty, které jsou vyžadovány pro opravy za tepla.

    Další informace najdete v tématu /hotpatch (vytvoření image s možností obnovení za běhu).

  • DebugInformationFormat

    Volitelný parametr String.

    Vybere typ informací o ladění vytvořených pro váš program a zda se tyto informace uchovávají v souborech objektů (.obj) nebo v databázi programu (PDB).

    Zadejte jednu z následujících hodnot, z nichž každá odpovídá možnosti příkazového řádku.

  • DisableLanguageExtensions

    Volitelný logický parametr.

    Pokud je pravda, sdělí kompilátoru, aby vygeneroval chybu pro jazykové konstrukce, které nejsou kompatibilní se standardem ANSI C nebo ANSI C++.

    Další informace najdete v části /Za v /Za, /Ze (zakázání jazykových rozšíření).

  • DisableSpecificWarnings

    Volitelný parametr String[]

    Zakáže čísla upozornění zadaná v seznamu oddělených středníkem.

    Další informace najdete v tématu /wd /w, /W0, /W1, /W2, /W3, /W4, /w1, /w2, /w3, /w4, /Wall, /wd, /we, /wo, /Wv, /WX (úroveň upozornění).

  • EnableEnhancedInstructionSet

    Volitelný parametr String.

    Určuje architekturu pro generování kódu, která používá instrukce STREAM SIMD Extensions (SSE), Streaming SIMD Extensions 2 (SSE2) a Advanced Vector Extensions (AVX).

    Zadejte jednu z následujících hodnot, z nichž každá odpovídá možnosti příkazového řádku.

    • NoExtensions - /arch:IA32

    • StreamSIMDExtensions - /arch:SSE

    • StreamingSIMDExtensions2 - /arch:SSE2

    • AdvancedVectorExtensions - /arch:AVX

    • AdvancedVectorExtensions2 - /arch:AVX2

    • AdvancedVectorExtensions512 - /arch:AVX512

      Další informace naleznete v tématu /arch (x86).

  • EnableFiber Sejf Optimizations

    Volitelný logický parametr.

    Pokud truepodporuje bezpečnost vláken pro data přidělená pomocí statického úložiště thread-local, to znamená data přidělená pomocí __declspec(thread).

    Další informace najdete v tématu /GT (podpora úložiště thread-safe thread-local).

  • EnablePREfast

    Volitelný logický parametr.

    Pokud true, povolte analýzu kódu.

    Další informace naleznete v tématu /analyze (analýza kódu).

  • ErrorReporting

    Volitelný parametr String.

    Umožňuje přímo společnosti Microsoft poskytnout informace o vnitřní chybě kompilátoru (ICE). Ve výchozím nastavení je nastavení v sestaveních IDE příkazový řádek a nastavení v sestaveních příkazového řádku je Fronta.

    Zadejte jednu z následujících hodnot, z nichž každá odpovídá možnosti příkazového řádku.

  • ExceptionHandling

    Volitelný parametr String.

    Určuje model zpracování výjimek, který bude kompilátor používat.

    Zadejte jednu z následujících hodnot, z nichž každá odpovídá možnosti příkazového řádku.

  • ExpandAttributedSource

    Volitelný logický parametr.

    Pokud true, vytvoří výpis soubor s rozbalenými atributy vložené do zdrojového souboru.

    Další informace naleznete v tématu /Fx (sloučení vložený kód).

  • FavorSizeOrSpeed

    Volitelný parametr String.

    Určuje, jestli chcete upřednostnění velikosti kódu nebo rychlosti kódu.

    Zadejte jednu z následujících hodnot, z nichž každá odpovídá možnosti příkazového řádku.

  • FloatingPointExceptions

    Volitelný logický parametr.

    Pokud truepovolí spolehlivý model výjimek s plovoucí desetinou čárkou. Výjimky budou vyvolány okamžitě po jejich aktivaci.

    Další informace najdete v parametru /fp:except v /fp (určení chování s plovoucí desetinou čárkou).

  • FloatingPointModel

    Volitelný parametr String.

    Nastaví model s plovoucí desetinou čárkou.

    Zadejte jednu z následujících hodnot, z nichž každá odpovídá možnosti příkazového řádku.

  • ForceConformanceInForLoopScope

    Volitelný logický parametr.

    Pokud trueimplementuje standardní chování jazyka C++ ve smyčce, které používají rozšíření Microsoftu (/Ze).

    Další informace naleznete v tématu /Zc:forScope (vynucení shody v oboru smyčky).

  • ForcedIncludeFiles

    Volitelný String[] parametr.

    Způsobí, že preprocesor zpracuje jeden nebo více zadaných souborů hlaviček.

    Další informace naleznete v tématu /FI (název vynucené zahrnutí souboru).

  • ForcedUsingFiles

    Volitelný parametr String[]

    Způsobí, že preprocesor zpracuje jeden nebo více zadaných #using souborů.

    Další informace najdete v tématu /FU (název vynucené #using souboru).

  • FunctionLevelLinking

    Volitelný Boolean parametr.

    Pokud trueumožňuje kompilátoru zabalit jednotlivé funkce ve formě zabalených funkcí (COMDAT).

    Další informace najdete v tématu /Gy (povolení propojení na úrovni funkce).

  • GenerateXMLDocumentationFiles

    Volitelný Boolean parametr.

    Pokud truezpůsobí, že kompilátor zpracuje komentáře dokumentace v souborech zdrojového kódu a vytvoří soubor .xdc pro každý soubor zdrojového kódu, který má komentáře dokumentace.

    Další informace najdete v tématu /doc (zpracování komentářů k dokumentaci) (C/C++). Viz také parametr XMLDocumentationFileName v této tabulce.

  • IgnoreStandardIncludePath

    Volitelný Boolean parametr.

    Pokud truezabrání kompilátoru v hledání souborů include v adresářích zadaných v proměnných prostředí PATH a INCLUDE.

    Další informace najdete v tématu /X (ignorování standardních cest zahrnutí).

  • InlineFunctionExpansion

    Volitelný parametr String .

    Určuje úroveň rozšíření vložené funkce pro sestavení.

    Zadejte jednu z následujících hodnot, z nichž každá odpovídá možnosti příkazového řádku.

  • Vnitřní funkce

    Volitelný Boolean parametr.

    Pokud truenahradí některá volání funkce vnitřními nebo jinak speciálními formuláři funkce, které vaší aplikaci pomůžou rychleji běžet.

    Další informace naleznete v tématu /Oi (generování vnitřních funkcí).

  • MinimalRebuild

    Volitelný Boolean parametr. Tato možnost je zastaralá.

    Pokud truepovolí minimální opětovné sestavení, které určuje, zda zdrojové soubory C++, které zahrnují změněné definice tříd C++ (uložené v hlavičce (.h) musí být rekompilovány.

    Další informace najdete v tématu /Gm (povolení minimálního opětovného sestavení).

  • MultiProcessorCompilation

    Volitelný Boolean parametr.

    Pokud truek kompilaci použijte více procesorů. Tento parametr vytvoří proces pro každý efektivní procesor ve vašem počítači.

    Další informace najdete v tématu /MP (sestavení s více procesy). Viz také parametr ProcessorNumber v této tabulce.

  • ObjectFileName

    Volitelný parametr String .

    Určuje název souboru nebo adresář (.obj), který se má použít místo výchozího objektu.

    Další informace naleznete v tématu /Fo (název souboru objektu).

  • Objektové soubory

    Volitelný parametr String[]

    Seznam souborů objektů.

  • OmitDefaultLibName

    Volitelný Boolean parametr.

    Pokud truevynechá výchozí název knihovny runtime jazyka C ze souboru objektu (.obj). Ve výchozím nastavení kompilátor umístí název knihovny do souboru .obj , aby linker směroval na správnou knihovnu.

    Další informace naleznete v tématu /Zl (vynechání výchozího názvu knihovny).

  • Vynechání elementůFramePointers

    Volitelný Boolean parametr.

    Pokud true, potlačuje vytváření ukazatelů rámce v zásobníku volání.

    Další informace najdete v tématu /Oy (vynechání ukazatele rámce).

  • OpenMPSupport

    Volitelný Boolean parametr.

    Pokud truezpůsobí, že kompilátor zpracuje klauzule a direktivy OpenMP.

    Další informace najdete v tématu /openmp (povolení podpory OpenMP 2.0).

  • Optimalizace

    Volitelný parametr String .

    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á možnosti příkazového řádku.

  • PrekompiledHeader

    Volitelný parametr String .

    Vytvořte nebo použijte předkompilovaný soubor hlavičky (.pch) během sestavení.

    Zadejte jednu z následujících hodnot, z nichž každá odpovídá možnosti příkazového řádku.

  • PředkompiledHeaderFile

    Volitelný parametr String .

    Určuje předkompilovaný název souboru hlavičky, který se má vytvořit nebo použít.

    Další informace najdete v tématu /Yc (vytvoření předkompilovaného hlavičkového souboru) a /Yu (použití předkompilovaného hlavičkového souboru).

  • PředkompiledHeaderOutputFile

    Volitelný parametr String .

    Určuje název cesty pro předkompilované záhlaví místo použití výchozího názvu cesty.

    Další informace naleznete v tématu /Fp (název souboru .pch).

  • PreprocessKeepComments

    Volitelný Boolean parametr.

    Pokud trueběhem předběžného zpracování zachová komentáře.

    Další informace naleznete v tématu /C (zachování komentářů během předběžného zpracování).

  • PreprocessorDefinitions

    Volitelný String[] parametr.

    Definuje symbol předběžného zpracování pro zdrojový soubor.

    Další informace najdete v tématu /D (definice preprocesoru).

  • Předběžné zpracováníOutput

    Volitelný ITaskItem[] parametr.

    Definuje pole výstupních položek preprocesoru, které lze využívat a generovat úkoly.

  • PreprocessOutputPath

    Volitelný String parametr.

    Určuje název výstupního souboru, do kterého parametr PreprocessToFile zapisuje předzpracovaný výstup.

    Další informace najdete v tématu /Fi (název výstupního souboru předzpracování).

  • PreprocessSuppressLineNumbers

    Volitelný Boolean parametr.

    Pokud truepředzpracuje zdrojové soubory C a C++ a zkopíruje předzpracované soubory do standardního výstupního zařízení.

    Další informace naleznete v tématu /EP (preprocess to stdout bez direktiv #line).

  • PreprocessToFile

    Volitelný Boolean parametr.

    Pokud truepředzpracuje zdrojové soubory C a C++ a zapíše předzpracovaný výstup do souboru.

    Další informace naleznete v tématu /P (předběžné zpracování souboru).

  • ProcessorNumber

    Volitelný Integer parametr.

    Určuje maximální počet procesorů, které se mají použít v multiprocesorové kompilaci. Tento parametr použijte v kombinaci s parametrem MultiProcessorCompilation .

  • ProgramDataBaseFileName

    Volitelný String parametr.

    Určuje název souboru pro programovou databázi (PDB).

    Další informace naleznete v tématu /Fd (název souboru databáze programu).

  • RuntimeLibrary

    Volitelný String parametr.

    Určuje, zda je multithreaded modul knihovnou DLL a vybere maloobchodní nebo ladicí verze knihovny runtime.

    Zadejte jednu z následujících hodnot, z nichž každá odpovídá možnosti příkazového řádku.

  • RuntimeTypeInfo

    Volitelný Boolean parametr.

    Pokud truepřidá kód pro kontrolu typů objektů jazyka C++ za běhu (informace o typu runtime).

    Další informace naleznete v tématu /GR (povolení informací o typu za běhu).

  • ShowIncludes

    Volitelný Boolean parametr.

    Pokud truezpůsobí, že kompilátor vypíše seznam souborů zahrnutí.

    Další informace naleznete v tématu /showIncludes (seznam zahrnutí souborů).

  • SmallerTypeCheck

    Volitelný Boolean parametr.

    Pokud true, hlásí chybu za běhu, pokud je hodnota přiřazena k menšímu datovému typu a způsobí ztrátu dat.

    Další informace najdete v části /RTCc v /RTC (kontroly chyb za běhu).

  • Zdrojů

    Požadovaný parametr ITaskItem[].

    Určuje seznam zdrojových souborů oddělených mezerami.

  • Zařazování řetězců

    Volitelný Boolean parametr.

    Pokud true, umožňuje kompilátoru vytvořit jednu kopii identických řetězců v imagi programu.

    Další informace naleznete v tématu /GF (vyloučení duplicitních řetězců).

  • 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á možnosti příkazového řádku.

  • SuppressStartupBanner

    Volitelný Boolean parametr.

    Pokud truepři spuštění úkolu zabrání zobrazení zprávy o autorských právech a čísle verze.

    Další informace naleznete v tématu /nologo (potlačení úvodního banneru) (C/C++).

  • TrackerLogDirectory

    Volitelný String parametr.

    Určuje zprostředkující adresář, ve kterém jsou uloženy protokoly sledování pro tuto úlohu.

    Další informace naleznete v TLogReadFiles a TLogWriteFiles parametry v této tabulce.

  • TreatSpecificWarningsAsErrors

    Volitelný parametr String[]

    Zachází se zadaným seznamem upozornění kompilátoru jako s chybami.

    Další informace najdete v možnosti /wen v /w, /W0, /W1, /W2, /W3, /W4, /w1, /w2, /w3, /w4, /Wall, /wd, /we, /wo, /Wv, /WX (úroveň upozornění).

  • TreatWarningAsError

    Volitelný Boolean parametr.

    Pokud truese zachází se všemi upozorněními kompilátoru jako s chybami.

    Další informace naleznete v tématu /w, /W0, /W1, /W2, /W3, /W4, /w1, /w2, /w3, /w4, /w4, /Wall, /wd, /we, /wo, /Wv, /WX (úroveň upozornění).

  • TreatWChar_tAsBuiltInType

    Volitelný Boolean parametr.

    Pokud trues typem wchar_t zachází jako s nativním typem.

    Další informace najdete v tématu /Zc:wchar_t (wchar_t je nativní typ).

  • UndefineAllPreprocessorDefinitions

    Volitelný Boolean parametr.

    Pokud truenedefinuje symboly specifické pro Microsoft, které kompilátor definuje.

    Další informace najdete v možnosti /u v /U, /u (nedefinovat symboly).

  • UndefinePreprocessorDefinitions

    Volitelný String[] parametr.

    Určuje seznam jednoho nebo více symbolů preprocesoru, které se nedefinují.

    Další informace naleznete v tématu /U option in /U, /u (nedefinovat symboly).

  • UseFullPaths

    Volitelný Boolean parametr.

    Pokud truezobrazí úplnou cestu k souborům zdrojového kódu předávaných kompilátoru v diagnostice.

    Další informace najdete v tématu /FC (úplná cesta k souboru zdrojového kódu v diagnostice).

  • UseUnicodeForAssemblerListing

    Volitelný Boolean parametr.

    Pokud truezpůsobí vytvoření výstupního souboru ve formátu UTF-8.

    Další informace najdete v možnosti /FAu v /FA, /Fa (soubor výpisu).

  • WarningLevel

    Volitelný String parametr.

    Určuje nejvyšší úroveň upozornění, která se má vygenerovat kompilátorem.

    Zadejte jednu z následujících hodnot, z nichž každá odpovídá možnosti příkazového řádku.

  • Kdo leProgramOptimization

    Volitelný Boolean parametr.

    Pokud truepovolíte optimalizaci celého programu.

    Další informace najdete v tématu /GL (optimalizace programu Kdo le).

  • XMLDocumentationFileName

    Volitelný String parametr.

    Určuje název vygenerovaných souborů dokumentace XML. Tento parametr může být název souboru nebo adresáře.

    Další informace najdete v argumentu name /doc (zpracování komentářů dokumentace) (C/C++). Viz také GenerateXMLDocumentationFiles parametr v této tabulce.

  • MinimalRebuildFromTracking

    Volitelný Boolean parametr.

    Pokud truese provede sledované přírůstkové sestavení; pokud falsese provede opětovné sestavení.

  • TLogReadFiles

    Volitelný ITaskItem[] parametr.

    Určuje pole položek, které představují protokoly sledování souborů pro čtení.

    Protokol sledování souborů pro čtení (.tlog) obsahuje názvy vstupních souborů přečtených úkolem a používá ho systém sestavení projektu k podpoře přírůstkových sestavení. Další informace naleznete v části TrackerLogDirectory a TrackFileAccess parametry v této tabulce.

  • TLogWriteFiles

    Volitelný ITaskItem[] parametr.

    Určuje pole položek, které představují protokoly sledování souborů zápisu.

    Protokol pro sledování souborů zápisu (.tlog) obsahuje názvy výstupních souborů, které jsou zapsány úkolem, a používá ho systém sestavení projektu k podpoře přírůstkových sestavení. Další informace naleznete v části TrackerLogDirectory a TrackFileAccess parametry v této tabulce.

  • TrackFileAccess

    Volitelný Boolean parametr.

    Pokud true, sleduje vzory přístupu k souborům.

    Další informace naleznete v TLogReadFiles a TLogWriteFiles parametry v této tabulce.

Viz také