/Yc (Crea il file di intestazione precompilato)

  • Articolo

Indica al compilatore di creare un file di intestazione precompilato (con estensione pch) che rappresenta lo stato della compilazione in un determinato punto.

Sintassi

/Yc
/Ycfilename

Argomenti

filename
Specifica un file di intestazione (h). Quando viene usato questo argomento, il compilatore compila tutto il codice fino al file h incluso.

Osservazioni:

Quando /Yc viene specificato senza un argomento, il compilatore compila tutto il codice fino alla fine del file di origine di base o al punto nel file di base in cui si verifica una direttiva hdrstop . Il file con estensione pch risultante ha lo stesso nome di base del file di origine di base, a meno che non si specifichi un nome di file diverso usando 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 e un'estensione pch. È anche possibile usare /Fp (Nome . Opzione Pch File) per specificare un nome per il file di intestazione precompilato.

Se si usa /Ycfilename, il compilatore compila tutto il codice fino al file specificato per usarlo successivamente con l'opzione /Yu (Usa file di intestazione precompilato).

Se le opzioni /Ycfilename e /Yufilename si verificano nella stessa riga di comando e entrambi i riferimenti o implicano lo stesso nome file, /Ycfilename ha la precedenza. Questa funzionalità semplifica la scrittura di makefile.

Per altre informazioni sulle intestazioni precompilate, vedere:

Per impostare l'opzione del compilatore nell'ambiente di sviluppo di Visual Studio

  1. Selezionare un file .cpp. Il file .cpp deve #include il file h contenente informazioni sull'intestazione precompilata. L'impostazione /Yc del progetto può essere sostituita a livello di file.

  2. Aprire la finestra di dialogo Pagine delle proprietà del progetto. Per informazioni dettagliate, vedere Impostare il compilatore e le proprietà di compilazione.

  3. Aprire la pagina delle proprietà Proprietà di configurazione, C/C++, Intestazioni precompilate .

  4. Modificare la proprietà Intestazione precompilata.

  5. Per impostare il nome file, modificare la proprietà File di intestazione precompilata.

Per impostare l'opzione del compilatore a livello di codice

Esempio

Si consideri il seguente codice :

// 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
// ...

Quando questo codice viene compilato con il comando CL /YcMYAPP.H PROG.CPP, il compilatore salva tutta la pre-elaborazione per AFXWIN.h, RESOURCE.h e MYAPP.h in un file di intestazione precompilato denominato MYAPP.pch.

Vedi anche

Opzioni del compilatore MSVC
Sintassi della riga di comando del compilatore MSVC
File di intestazione precompilata