/Yc (Crea il file di intestazione precompilato)
Indica al compilatore di creare un file di intestazione precompilata (pch) che rappresenta lo stato della compilazione in un determinato punto.
/Yc[filename]
Argomenti
- filename
Specifica un file di intestazione (estensione h). Quando si utilizza questo argomento, viene compilato tutto il codice fino al file di intestazione incluso.
Note
Quando si specifica /Yc senza un argomento, viene compilato tutto il codice fino alla fine del file di origine di base oppure fino al punto del file di base in cui si verifica un pragma hdrstop. Il file pch risultante ha lo stesso nome del file di origine di base, a meno che non si specifichi un nome file diverso utilizzando il pragma hdrstop o l'opzione /Fp.
Il codice precompilato viene salvato in un file con un nome creato dal nome di base del file specificato con l'opzione /Yc ed estensione pch. Per specificare un nome per un file di intestazione precompilata, è inoltre possibile utilizzare l'opzione /Fp (Specifica file pch).
Se si utilizza /Ycfilename, verrà compilato tutto il codice fino al file specificato incluso, per un utilizzo successivo con l'opzione /Yu.
Se le opzioni /Ycfilename e /Yu (Utilizza il file di intestazione precompilato)filename sono specificate nella stessa riga di comando ed entrambe fanno riferimento o implicano lo stesso nome file, /Ycfilename avrà la precedenza. Questa funzionalità semplifica la scrittura di makefile.
Per ulteriori informazioni sulle intestazioni precompilate, vedere:
Per impostare l'opzione del compilatore nell'ambiente di sviluppo di Visual Studio
Selezionare un file cpp. Il file cpp deve includere il file con estensione h contenente le informazioni sull'intestazione precompilata. Le impostazioni di /Yc del progetto possono essere sottoposte a override a livello di file.
Aprire la finestra di dialogo Pagine delle proprietà del progetto. Per informazioni dettagliate, vedere Procedura: aprire le pagine delle proprietà dei progetti.
Fare clic sulla cartella C/C++.
Fare clic sulla pagina delle proprietà Intestazioni precompilate.
Modificare la proprietà Crea/Usa PCH tramite file o la proprietà Crea/Usa intestazione precompilata.
Per impostare l'opzione del compilatore a livello di codice
- Vedere PrecompiledHeaderThrough e UsePrecompiledHeader.
Esempio
Si consideri il codice seguente:
#include <afxwin.h> // Include header for class library
#include "resource.h" // Include resource definitions
#include "myapp.h" // Include information specific to this app
...
Quando il codice viene compilato con il comando CL /YcMYAPP.H PROG.CPP, il compilatore salva tutta la pre-elaborazione relativa a AFXWIN.h, RESOURCE.h e MYAPP.h in un file di intestazione precompilata denominato MYAPP.pch.