Bagikan melalui

Tugas CL

  • Artikel

Catatan

Tugas ini hanya tersedia saat menggunakan sistem build C++.

Bungkus alat pengkompilasi Microsoft C++,cl.exe. Pengkompilasi menghasilkan file yang dapat dieksekusi (.exe), file pustaka tautan dinamis (.dll), atau modul kode (.netmodule). Untuk informasi selengkapnya, lihat Opsi penaut dan Gunakan MSBuild dari baris perintah dan Menggunakan toolset Microsoft C++ dari baris perintah.

Parameter

Daftar berikut menjelaskan parameter tugas CL. Sebagian besar parameter tugas, dan beberapa set parameter, sesuai dengan opsi baris perintah.

  • AdditionalIncludeDirectories

    Parameter string opsional.

    Tambahkan direktori ke daftar direktori yang dicari untuk menyertakan file.

    Untuk informasi selengkapnya, lihat /I (Tambahan menyertakan direktori).

  • AdditionalOptions

    Parameter string opsional.

    Daftar opsi baris perintah. Misalnya, /<option1> /<option2> /<option#>. Gunakan parameter ini untuk menentukan opsi baris perintah yang tidak diwakili oleh setiap parameter tugas lainnya.

    Untuk informasi selengkapnya, lihat Opsi Kompilator.

  • AdditionalUsingDirectories

    Parameter string opsional.

    Menentukan direktori yang akan dicari pengkompilasi untuk menyelesaikan referensi file yang diteruskan ke direktif #using.

    Untuk informasi selengkapnya, lihat /AI (Tentukan direktori metadata).

  • AlwaysAppend

    Parameter string opsional.

    String yang selalu dipancarkan pada baris perintah. Nilai defaultnya adalah “/c”.

  • AssemblerListingLocation

    Buat file daftar yang berisi kode rakitan.

    Untuk informasi selengkapnya, lihat opsi /Fa di /FA, /Fa (File daftar).

  • AssemblerOutput

    Parameter string opsional.

    Buat file daftar yang berisi kode rakitan.

    Tentukan salah satu dari nilai berikut, yang masing-masing sesuai dengan opsi baris perintah.

    • TanpaDaftar - <Tidak>

    • AssemblyCode - /FA

    • AssemblyAndMachineCode - /FAc

    • AssemblyAndSourceCode - /FAs

    • All - /FAcs

      Untuk informasi selengkapnya, lihat opsi /FA, /FAc, /FAs, dan /FAcs di /FA, /Fa (File daftar).

  • BasicRuntimeChecks

    Parameter string opsional.

    Aktifkan dan nonaktifkan fitur pemeriksaan kesalahan run-time, bersama dengan pragma runtime_checks.

    Tentukan salah satu dari nilai berikut, yang masing-masing sesuai dengan opsi baris perintah.

    • Default - <none>

    • StackFrameRuntimeCheck - /RTCs

    • UninitializedLocalUsageCheck - /RTCu

    • EnableFastChecks - /RTC1

      Untuk informasi selengkapnya, lihat /RTC (Pemeriksaan kesalahan run-time).

  • InformasiPeramban

    Parameter Boolean opsional.

    Jika true, buat file informasi peramban.

    Untuk informasi selengkapnya, lihat opsi /FR di /FR, /Fr (Buat file .sbr).

  • FileInformasiPeramban

    Parameter string opsional.

    Tentukan nama file untuk file informasi peramban.

    Untuk informasi selengkapnya, lihat parameter InformasiPeramban dalam tabel ini, dan lihat juga /FR, /Fr (Buat file .sbr).

  • BufferSecurityCheck

    Parameter Boolean opsional.

    Jika true, mendeteksi beberapa overrun buffer yang menimpa alamat pengembalian, teknik umum untuk mengeksploitasi kode yang tidak memberlakukan pembatasan ukuran buffer.

    Untuk informasi selengkapnya, lihat /GS (Pemeriksaan keamanan buffer).

  • BuildingInIDE

    Parameter Boolean opsional.

    Jika true, menunjukkan bahwa MSBuild dipanggil oleh IDE. Jika tidak, MSBuild dipanggil pada baris perintah.

  • CallingConvention

    Parameter string opsional.

    Menentukan konvensi panggilan, yang menentukan urutan di mana argumen fungsi didorong ke tumpukan, apakah fungsi pemanggil atau fungsi yang dipanggil menghapus argumen dari tumpukan di akhir panggilan, dan konvensi dekorasi nama yang digunakan pengkompilasi untuk mengidentifikasi fungsi individual.

    Tentukan salah satu dari nilai berikut, yang masing-masing sesuai dengan opsi baris perintah.

  • CompileAs

    Parameter string opsional.

    Menentukan apakah akan mengkompilasi file input sebagai file sumber C atau C++.

    Tentukan salah satu dari nilai berikut, yang masing-masing sesuai dengan opsi baris perintah.

  • CompileAsManaged

    Parameter string opsional.

    Memungkinkan aplikasi dan komponen menggunakan fitur dari runtime bahasa umum (CLR).

    Tentukan salah satu dari nilai berikut, yang masing-masing sesuai dengan opsi baris perintah.

  • CreateHotpatchableImage

    Parameter Boolean opsional.

    Jika true, informasikan pengkompilasi untuk menyiapkan gambar untuk patching panas. Parameter ini memastikan bahwa instruksi pertama dari setiap fungsi adalah dua byte, yang diperlukan untuk patching panas.

    Untuk informasi lebih lanjut, lihat /FUNCTIONPADMIN (Membuat gambar hotpatchable).

  • DebugInformationFormat

    Parameter string opsional.

    Memilih jenis informasi penelusuran kesalahan yang dibuat untuk program Anda dan apakah informasi ini disimpan dalam file objek (.obj) atau dalam database program (PDB).

    Tentukan salah satu dari nilai berikut, yang masing-masing sesuai dengan opsi baris perintah.

  • DisableLanguageExtensions

    Parameter Boolean opsional.

    Jika true, memberi tahu kompilator untuk memancarkan kesalahan untuk konstruksi bahasa yang tidak kompatibel dengan ANSI C atau ANSI C++.

    Untuk informasi selengkapnya, lihat opsi /Za di /Za, /Ze (Nonaktifkan ekstensi bahasa).

  • DisableSpecificWarnings

    Parameter string opsional.

    Nonaktifkan nomor peringatan yang ditentukan dalam daftar yang dibatasi titik koma.

    Untuk informasi selengkapnya, lihat opsi /wd dalam /w, /W0, /W1, /W2, /W3, /W4, /w1, /w2, /w3, /w4, /Wall, /wd, /we, /wo, /Wv, /WX (Tingkat peringatan).

  • EnableEnhancedInstructionSet

    Parameter string opsional.

    Menentukan arsitektur untuk pembuatan kode yang menggunakan instruksi Streaming SIMD Extensions (SSE), Streaming SIMD Extensions 2 (SSE2) dan Advanced Vector Extensions (AVX).

    Tentukan salah satu dari nilai berikut, yang masing-masing sesuai dengan opsi baris perintah.

    • NoExtensions - /arch:IA32

    • StreamingSIMDExtensions - /arch:SSE

    • StreamingSIMDExtensions2 - /arch:SSE2

    • AdvancedVectorExtensions - /arch:AVX

    • AdvancedVectorExtensions2 - /arch:AVX2

    • AdvancedVectorExtensions512 - /arch:AVX512

      Untuk informasi selengkapnya, lihat /arch (x86).

  • EnableFiberSafeOptimizations

    Parameter Boolean opsional.

    Jika true, mendukung keamanan serat untuk data yang dialokasikan dengan menggunakan penyimpanan lokal utas statis, yaitu data yang dialokasikan dengan menggunakan __declspec(thread).

    Untuk informasi selengkapnya, lihat /GT (Mendukung penyimpanan utas-lokal yang aman serat).

  • EnablePREfast

    Parameter Boolean opsional.

    Jika true, aktifkan analisis kode.

    Untuk informasi selengkapnya, lihat Analisis kode di.NET.

  • ErrorReporting

    Parameter string opsional.

    Memungkinkan Anda memberikan informasi kesalahan kompiler internal (ICE) langsung ke Microsoft. Secara default, pengaturan dalam build IDE adalah Prompt dan pengaturan dalam build baris perintah adalah Antrean.

    Tentukan salah satu dari nilai berikut, yang masing-masing sesuai dengan opsi baris perintah.

  • ExceptionHandling

    Parameter string opsional.

    Menentukan model penanganan pengecualian yang akan digunakan oleh pengkompilasi.

    Tentukan salah satu dari nilai berikut, yang masing-masing sesuai dengan opsi baris perintah.

  • ExpandAttributedSource

    Parameter Boolean opsional.

    Jika true, membuat file daftar yang memiliki atribut yang diperluas yang disuntikkan ke dalam file sumber.

    Untuk informasi selengkapnya, lihat /Fx (Gabungkan kode yang disuntikkan).

  • FavorSizeOrSpeed

    Parameter string opsional.

    Menentukan apakah akan mendukung ukuran kode atau kecepatan kode.

    Tentukan salah satu dari nilai berikut, yang masing-masing sesuai dengan opsi baris perintah.

  • FloatingPointExceptions

    Parameter Boolean opsional.

    Jika true, memungkinkan model pengecualian titik-ambang yang andal. Pengecualian akan dimunculkan segera setelah dipicu.

    Untuk informasi selengkapnya, lihat opsi /fp:except di /fp (Tentukan perilaku titik-ambang).

  • ModelTitikAmbang

    Parameter string opsional.

    Atur model titik ambang.

    Tentukan salah satu dari nilai berikut, yang masing-masing sesuai dengan opsi baris perintah.

  • ForceConformanceInForLoopScope

    Parameter Boolean opsional.

    Jika true, menerapkan perilaku C++ standar untuk perulangan yang menggunakan ekstensi Microsoft (/Ze).

    Untuk informasi selengkapnya, lihat /Zc:forScope (Force conformance in for loop scope).

  • ForcedIncludeFiles

    Parameter String[] opsional.

    Menyebabkan prapemroses memproses satu atau beberapa file header yang ditentukan.

    Untuk informasi selengkapnya, lihat /FI (Nama dipaksa menyertakan file).

  • ForcedUsingFiles

    Parameter String[] opsional.

    Menyebabkan prapemroses memproses satu atau beberapa file #using yang ditentukan.

    Untuk informasi selengkapnya, lihat /FU (Nama memaksa file #using).

  • FunctionLevelLinking

    Parameter Boolean opsional.

    Jika true, aktifkan pengkompilasi untuk mengemas fungsi individual dalam bentuk fungsi kemasan (COMDAT).

    Untuk informasi selengkapnya, lihat /Gy (Aktifkan penautan tingkat fungsi).

  • GenerateXMLDocumentationFiles

    Parameter Boolean opsional.

    Jika true, menyebabkan pengkompilasi memproses komentar dokumentasi dalam file kode sumber dan membuat file .xdc untuk setiap file kode sumber yang memiliki komentar dokumentasi.

    Untuk informasi selengkapnya, lihat /doc (Memproses komentar dokumentasi) (C/C++). Lihat juga parameter XMLDocumentationFileName dalam tabel ini.

  • IgnoreStandardIncludePath

    Parameter Boolean opsional.

    Jika true, mencegah pengkompilasi mencari file yang disertakan dalam direktori yang ditentukan dalam variabel lingkungan PATH dan INCLUDE.

    Untuk informasi selengkapnya, lihat /X (Abaikan jalur termasuk standar).

  • InlineFunctionExpansion

    Parameter String opsional.

    Tentukan tingkat ekspansi fungsi sebaris untuk build.

    Tentukan salah satu dari nilai berikut, yang masing-masing sesuai dengan opsi baris perintah.

    • Default - <none>

    • Dinonaktifkan - /Ob0

    • OnlyExplicitInline - /Ob1

    • AnySuitable - /Ob2

      Untuk informasi selengkapnya, lihat /Ob (Ekspansi fungsi sebaris).

  • IntrinsicFunctions

    Parameter Boolean opsional.

    Jika true, mengganti beberapa panggilan fungsi dengan bentuk fungsi intrinsik atau khusus yang membantu aplikasi Anda berjalan lebih cepat.

    Untuk informasi selengkapnya, lihat /Oi (Hasilkan fungsi intrinsik).

  • MinimalRebuild

    Parameter Boolean opsional. Opsi ini tidak digunakan lagi.

    Jika true, aktifkan pembangunan ulang minimal, yang menentukan apakah file sumber C++ yang menyertakan definisi kelas C++ yang diubah (disimpan dalam file header (.h)) harus dikompilasi ulang.

    Untuk informasi selengkapnya, lihat /Gm (Aktifkan pembangunan ulang minimal).

  • MultiProcessorCompilation

    Parameter Boolean opsional.

    Jika true, gunakan beberapa prosesor untuk mengkompilasi. Parameter ini membuat proses untuk setiap prosesor yang efektif pada komputer Anda.

    Untuk informasi selengkapnya, lihat /MP (Bangun dengan beberapa proses). Lihat juga parameter ProcessorNumber dalam tabel ini.

  • ObjectFileName

    Parameter String opsional.

    Tentukan nama file objek (.obj) atau direktori yang akan digunakan alih-alih default.

    Untuk informasi selengkapnya, lihat /Fo (Nama file objek).

  • ObjectFiles

    Parameter String[] opsional.

    Daftar file objek.

  • OmitDefaultLibName

    Parameter Boolean opsional.

    Jika true, menghilangkan nama pustaka run-time C default dari file objek (.obj). Secara default, pengkompilasi menempatkan nama pustaka ke dalam file .obj untuk mengarahkan penaut ke pustaka yang benar.

    Untuk informasi selengkapnya, lihat /Zl (Hilangkan nama pustaka default).

  • OmitFramePointers

    Parameter Boolean opsional.

    Jikatrue, sembunyikan pembuatan penunjuk bingkai pada tumpukan panggilan.

    Untuk informasi selengkapnya, lihat /Oy (Kelalaian penunjuk bingkai).

  • OpenMPSupport

    Parameter Boolean opsional.

    Jika true, menyebabkan kompilator memproses klausa dan arahan OpenMP.

    Untuk informasi selengkapnya, lihat /openmp (Aktifkan dukungan OpenMP 2.0).

  • Pengoptimalan

    Parameter String opsional.

    Tentukan berbagai pengoptimalan kode untuk kecepatan dan ukuran.

    Tentukan salah satu dari nilai berikut, yang masing-masing sesuai dengan opsi baris perintah.

    • Dinonaktifkan - /Ob0

    • MinSpace - /O1

    • MaxSpeed - /O2

    • Full - /Ox

      Untuk informasi selengkapnya, lihat Opsi /O (Optimalkan kode).

  • PrecompiledHeader

    Parameter String opsional.

    Buat atau gunakan file header (.pch) yang telah dikompilasikan sebelumnya selama build.

    Tentukan salah satu dari nilai berikut, yang masing-masing sesuai dengan opsi baris perintah.

  • PrecompiledHeaderFile

    Parameter String opsional.

    Tentukan nama file header yang telah dikompilasikan sebelumnya untuk dibuat atau digunakan.

    Untuk informasi selengkapnya, lihat /Yc (Buat file header yang telah dikompilasikan sebelumnya) dan /Yu (Gunakan file header yang telah dikompilasikan sebelumnya).

  • PrecompiledHeaderOutputFile

    Parameter String opsional.

    Tentukan nama jalur untuk header yang telah dikompilasikan sebelumnya alih-alih menggunakan nama jalur default.

    Untuk informasi selengkapnya, lihat /Fp (Nama file .pch).

  • PreprocessKeepComments

    Parameter Boolean opsional.

    Jika true, pertahankan komentar selama pra-pemrosesan.

    Untuk informasi selengkapnya, lihat /C (Pertahankan komentar selama pra-pemrosesan).

  • PreprocessorDefinitions

    Parameter String[] opsional.

    Tentukan simbol prapemrosesan untuk file sumber Anda.

    Untuk informasi selengkapnya, lihat /D (Definisi pra-prosesor).

  • PreprocessOutput

    Parameter ITaskItem[] opsional.

    Mendefinisikan array item output praprosesor yang dapat digunakan dan dipancarkan oleh tugas.

  • PreprocessOutputPath

    Parameter String opsional.

    Menentukan nama file output tempat parameter PreprocessToFile menulis output yang telah diproses sebelumnya.

    Untuk informasi selengkapnya, lihat /Fi (Nama file output praprosces).

  • PreprocessSuppressLineNumbers

    Parameter Boolean opsional.

    Jika true, praproses file sumber C dan C++ dan menyalin file yang telah diproses sebelumnya ke perangkat output standar.

    Untuk informasi selengkapnya, lihat /EP (Preprocess to stdout tanpa direktif #line).

  • PreprocessToFile

    Parameter Boolean opsional.

    Jika true, praproses file sumber C dan C++ dan menulis output yang telah diproses sebelumnya ke file.

    Untuk informasi selengkapnya, lihat /P (Praprosces ke file).

  • ProcessorNumber

    Parameter Integer opsional.

    Menentukan jumlah maksimum prosesor yang akan digunakan dalam kompilasi multiprosesor. Gunakan parameter ini dalam kombinasi dengan parameter MultiProcessorCompilation.

  • ProgramDataBaseFileName

    Parameter String opsional.

    Tentukan nama file untuk file database program (PDB).

    Untuk informasi selengkapnya, lihat /Fd (Nama file database program).

  • RuntimeLibrary

    Parameter String opsional.

    Menunjukkan apakah modul multithreaded adalah DLL, dan memilih versi ritel atau debug pustaka run-time.

    Tentukan salah satu dari nilai berikut, yang masing-masing sesuai dengan opsi baris perintah.

  • RuntimeTypeInfo

    Parameter Boolean opsional.

    Jika true, tambahkan kode untuk memeriksa jenis objek C++ pada run-time (informasi jenis run-time).

    Untuk informasi selengkapnya, lihat /GR (Aktifkan informasi jenis run-time).

  • ShowIncludes

    Parameter Boolean opsional.

    Jika true, menyebabkan pengkompilasi mengeluarkan daftar file yang disertakan.

    Untuk informasi selengkapnya, lihat /showIncludes (Daftar menyertakan file).

  • SmallerTypeCheck

    Parameter Boolean opsional.

    Jika true, laporkan kesalahan run-time jika nilai ditetapkan ke jenis data yang lebih kecil dan menyebabkan kehilangan data.

    Untuk informasi selengkapnya, lihat opsi /RTCc di /RTC (Pemeriksaan kesalahan run-time).

  • Sumber

    Parameter ITaskItem[] wajib.

    Tentukan daftar file sumber yang dipisahkan oleh spasi.

  • StringPooling

    Parameter Boolean opsional.

    Jika true, memungkinkan pengkompilasi untuk membuat satu salinan string yang identik dalam gambar program.

    Untuk informasi selengkapnya, lihat /GF (Menghilangkan string duplikat).

  • StructMemberAlignment

    Parameter String opsional.

    Tentukan perataan byte untuk semua anggota dalam struktur.

    Tentukan salah satu dari nilai berikut, yang masing-masing sesuai dengan opsi baris perintah.

    • Default - /Zp1

    • 1Byte - /Zp1

    • 2Bytes - /Zp2

    • 4Bytes - /Zp4

    • 8Bytes - /Zp8

    • 16Bytes - /Zp16

      Untuk informasi selengkapnya, lihat /Zp (Perataan anggota struct).

  • SuppressStartupBanner

    Parameter Boolean opsional.

    Jika true, mencegah tampilan pesan hak cipta dan nomor versi saat tugas dimulai.

    Untuk informasi lebih lanjut, lihat /NOLOGO (Menekan spanduk startup) (penaut).

  • TrackerLogDirectory

    Parameter String opsional.

    Tentukan direktori perantara tempat log pelacakan untuk tugas ini disimpan.

    Untuk informasi selengkapnya, lihat parameter TLogReadFiles dan TLogWriteFiles dalam tabel ini.

  • TreatSpecificWarningsAsErrors

    Parameter String[] opsional.

    Perlakukan daftar peringatan pengkompilasi yang ditentukan sebagai kesalahan.

    Untuk informasi selengkapnya, lihat opsi /wendalam /w, /W0, /W1, /W2, /W3, /W4, /w1, /w2, /w3, /w4, /Wall, /wd, /we, /wo, /Wv, /WX (Tingkat peringatan).

  • TreatWarningAsError

    Parameter Boolean opsional.

    Jika true,perlakukan semua peringatan pengompilasi sebagai kesalahan.

    Untuk informasi selengkapnya, lihat opsi /wedalam /w, /W0, /W1, /W2, /W3, /W4, /w1, /w2, /w3, /w4, /Wall, /wd, /we, /wo, /Wv, /WX (Tingkat peringatan).

  • TreatWChar_tAsBuiltInType

    Parameter Boolean opsional.

    Jika true, perlakukan wchar_t jenis sebagai jenis asli.

    Untuk informasi selengkapnya, lihat /Zc:wchar_t (wchar_t adalah jenis asli).

  • UndefineAllPreprocessorDefinitions

    Parameter Boolean opsional.

    Jika true, jangan tentukan simbol khusus Microsoft yang ditentukan pengkompilasi.

    Untuk informasi selengkapnya, lihat opsi /u di /U, /u (Simbol batalkan definisi).

  • UndefinePreprocessorDefinitions

    Parameter String[] opsional.

    Tentukan daftar satu atau beberapa simbol pra-prosesor untuk tidak didefinisikan.

    Untuk informasi selengkapnya, lihat opsi /u di /U, /u (Simbol batalkan definisi).

  • UseFullPaths

    Parameter Boolean opsional.

    Jika true, tampilkan jalur lengkap file kode sumber yang diteruskan ke pengkompilasi dalam diagnostik.

    Untuk informasi selengkapnya, lihat /FC (Jalur lengkap dari file kode sumber dalam diagnostik).

  • UseUnicodeForAssemblerListing

    Parameter Boolean opsional.

    Jika true, menyebabkan file output dibuat dalam format UTF-8.

    Untuk informasi selengkapnya, lihat opsi /Fa di /FA, /Fa (File daftar).

  • WarningLevel

    Parameter String opsional.

    Tentukan tingkat peringatan tertinggi yang akan dihasilkan oleh pengkompilasi.

    Tentukan salah satu dari nilai berikut, yang masing-masing sesuai dengan opsi baris perintah.

    • TurnOffAllWarnings - /W0

    • Level1 - /W1

    • Level2 - /W2

    • Level3 - /W3

    • Level4 - /W4

    • EnableAllWarnings - /Wall

      Untuk informasi selengkapnya, lihat opsi /wedalam /w, /W0, /W1, /W2, /W3, /W4, /w1, /w2, /w3, /w4, /Wall, /wd, /we, /wo, /Wv, /WX (Tingkat peringatan).

  • WholeProgramOptimization

    Parameter Boolean opsional.

    Jika true, aktifkan pengoptimalan seluruh program.

    Untuk informasi selengkapnya, lihat /GL (Pengoptimalan seluruh program).

  • XMLDocumentationFileName

    Parameter String opsional.

    Tentukan nama file dokumentasi XML yang dihasilkan. Parameter ini bisa berupa nama file atau direktori.

    Untuk informasi selengkapnya, lihat name argumen di /doc (Memproses komentar dokumentasi) (C/C++). Lihat juga parameter GenerateXMLDocumentationFiles dalam tabel ini.

  • MinimalRebuildFromTracking

    Parameter Boolean opsional.

    Jika true, build inkremental terlacak dilakukan; jika false, pembangunan ulang dilakukan.

  • TLogReadFiles

    Parameter ITaskItem[] opsional.

    Tentukan array item yang mewakili log pelacakan baca.

    Log pelacakan file baca (.tlog) berisi nama file input yang dibaca oleh tugas, dan digunakan oleh sistem build proyek untuk mendukung build inkremental. Untuk informasi selengkapnya, lihat parameter TrackerLogDirectory dan TrackFileAccess dalam tabel ini.

  • TLogWriteFiles

    Parameter ITaskItem[] opsional.

    Tentukan array item yang mewakili log pelacakan baca.

    Log pelacakan file baca (.tlog) berisi nama file input yang dibaca oleh tugas, dan digunakan oleh sistem build proyek untuk mendukung build inkremental. Untuk informasi selengkapnya, lihat parameter TrackerLogDirectory dan TrackFileAccess dalam tabel ini.

  • TrackFileAccess

    Parameter Boolean opsional.

    Jika true, lacak pola akses file.

    Untuk informasi selengkapnya, lihat parameter TLogReadFiles dan TLogWriteFiles dalam tabel ini.

Lihat juga