Bagikan melalui

/Yl (Menyuntikkan Referensi PCH untuk Pustaka Debug)

  • Artikel

Opsi /Yl menghasilkan simbol unik dalam file header yang telah dikommpilasikan sebelumnya, dan referensi ke simbol ini disuntikkan di semua file objek yang menggunakan header yang telah dikompretasi.

Sintaks

/Yl
Nama /Yl
/Yl-

Argumen

nama
Nama opsional yang digunakan sebagai bagian dari simbol unik.

-
Tanda hubung (-) secara eksplisit menonaktifkan opsi pengkompilasi /Yl .

Keterangan

Opsi pengkompilasi /Yl membuat definisi simbol unik dalam file header yang telah dikompilasi sebelumnya yang dibuat dengan menggunakan opsi /Yc . Referensi ke simbol ini secara otomatis disuntikkan di semua file yang menyertakan header yang telah dikompilasi sebelumnya dengan menggunakan opsi pengkompilasi /Yu . Opsi /Yl diaktifkan secara default ketika /Yc digunakan untuk membuat file header yang telah dikompilasi sebelumnya.

Opsi nama /Yldigunakan untuk membuat simbol yang dapat diidentifikasi dalam file header yang telah dikompretasi. Pengkompilasi menggunakan argumen nama sebagai bagian dari nama simbol yang didekorasi yang dibuatnya, mirip __@@_PchSym_@00@...@namedengan , di mana elipsis (...) mewakili string karakter unik yang dihasilkan kompilator. Jika argumen nama dihilangkan, pengkompilasi akan menghasilkan nama simbol secara otomatis. Biasanya, Anda tidak perlu mengetahui nama simbol. Namun, ketika proyek Anda menggunakan lebih dari satu file header yang telah dikommpilasikan sebelumnya, opsi nama /Ylmungkin berguna untuk menentukan file objek mana yang menggunakan header yang telah dikompeksi sebelumnya. Anda dapat menggunakan nama sebagai string pencarian untuk menemukan referensi simbol dalam file cadangan.

/Yl- menonaktifkan perilaku default dan tidak menempatkan simbol identifikasi dalam file header yang telah dikomprelasi. File yang dikompilasi yang menyertakan header yang telah dikompilasi ini tidak mendapatkan referensi simbol umum.

Ketika /Yc tidak ditentukan, opsi /Yl apa pun tidak berpengaruh, tetapi jika ditentukan, opsi /Yl harus cocok dengan opsi /Yl yang diteruskan saat /Yc ditentukan.

Jika Anda menggunakan opsi /Yl-, /Yc dan /Z7 untuk membuat file header yang telah dikompilasi sebelumnya, informasi penelusuran kesalahan disimpan dalam file objek untuk file sumber yang digunakan untuk membuat header yang telah dikompilasi sebelumnya, bukan file .pdb terpisah. Jika file objek ini kemudian dijadikan bagian dari pustaka, LNK1211 kesalahan atau peringatan LNK4206 dapat terjadi dalam build yang menggunakan pustaka ini dan file header yang telah dikompresi, jika file sumber yang digunakan untuk membuat file header yang telah dikompresi tidak menentukan simbol apa pun itu sendiri. Linker dapat mengecualikan file objek dari tautan, bersama dengan informasi penelusuran kesalahan terkait, ketika tidak ada dalam file objek yang dirujuk di klien pustaka. Untuk mengatasi masalah ini, tentukan /Yl (atau hapus opsi /Yl- ) saat Anda menggunakan /Yc untuk membuat file header yang telah dikommpilasikan sebelumnya. Ini memastikan bahwa file objek dari pustaka yang berisi informasi penelusuran kesalahan akan ditautkan dalam build Anda.

Untuk informasi selengkapnya tentang header yang telah dikommpilasikan sebelumnya, lihat:

Untuk mengatur opsi pengkompilasi ini di lingkungan pengembangan Visual Studio

  1. Buka kotak dialog Halaman Properti proyek. Untuk detailnya, lihat Mengatur pengkompilasi C++ dan membuat properti di Visual Studio.

  2. Pilih halaman properti Properti>Konfigurasi C/C++>Baris Perintah.

  3. Tambahkan opsi pengkompilasi nama /Yldi kotak Opsi Tambahan. Pilih OK untuk menyimpan perubahan.

Untuk mengatur opsi pengkompilasi ini secara terprogram

Baca juga

Opsi Pengkompilasi MSVC
Sintaks Baris Perintah Pengkompilasi MSVC