/Yc (Buat File Header yang Telah Dikomprelasi)

Artikel
10/12/2023

Menginstruksikan pengkompilasi untuk membuat file header (.pch) yang telah dikompilasi yang mewakili status kompilasi pada titik tertentu.

Sintaks

/Yc
Nama file /Yc

Argumen

filename
Menentukan file header (.h). Ketika argumen ini digunakan, pengkompilasi mengkompilasi semua kode hingga dan termasuk file .h.

Keterangan

Ketika /Yc ditentukan tanpa argumen, pengkompilasi mengkompilasi semua kode hingga akhir file sumber dasar, atau ke titik dalam file dasar tempat direktif hdrstop terjadi. File .pch yang dihasilkan memiliki nama dasar yang sama dengan file sumber dasar Anda kecuali Anda menentukan nama file yang berbeda menggunakan hdrstop pragma atau opsi /Fp .

Kode yang telah dikompilasi disimpan dalam file dengan nama yang dibuat dari nama dasar file yang ditentukan dengan opsi /Yc dan ekstensi .pch. Anda juga dapat menggunakan /Fp (Nama . Opsi File Pch) untuk menentukan nama untuk file header yang telah dikommpilasikan sebelumnya.

Jika Anda menggunakan nama file /Yc, pengkompilasi mengkompilasi semua kode hingga dan menyertakan file yang ditentukan untuk penggunaan berikutnya dengan opsi /Yu (Gunakan File Header Yang Telah Dikompilasi Sebelumnya).

Jika opsi /Ycfilename dan /Yufilename terjadi pada baris perintah yang sama dan kedua referensi, atau menyiratkan, nama file yang sama, nama file /Yclebih diutamakan. Fitur ini menyederhanakan penulisan makefiles.

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

Untuk mengatur opsi pengkompilasi ini di lingkungan pengembangan Visual Studio

Pilih file .cpp. File .cpp harus #include file .h yang berisi informasi header yang telah dikomputasi sebelumnya. Pengaturan /Yc proyek dapat ditimpa di tingkat file.
Buka kotak dialog Halaman Properti proyek. Untuk detailnya, lihat Mengatur pengkompilasi C++ dan membuat properti di Visual Studio.
Buka halaman properti Properti Konfigurasi, C/C++, Header yang Telah Dikommpilasikan sebelumnya.
Ubah properti Header yang Telah Dikompresi.
Untuk mengatur nama file, ubah properti File Header yang Telah Dikompresi.

Untuk mengatur opsi pengkompilasi ini secara terprogram

Lihat PrecompiledHeaderThrough dan UsePrecompiledHeader.

Contoh

Pertimbangkan gambar berikut:

// prog.cpp
// compile with: cl /c /Ycmyapp.h prog.cpp
#include <afxwin.h>   // Include header for class library
#include "resource.h" // Include resource definitions
#include "myapp.h"    // Include information specific to this app
// ...

Ketika kode ini dikompilasi dengan perintah CL /YcMYAPP.H PROG.CPP, pengkompilasi menyimpan semua pra-pemrosesan untuk AFXWIN.h, RESOURCE.h, dan MYAPP.h dalam file header yang telah dikompilasi sebelumnya yang disebut MYAPP.pch.

Bagikan melalui