Partager via

/Yc (Créer un fichier d'en-tête précompilé)

  • Article

Indique au compilateur de créer un fichier d’en-tête précompilé (.pch) qui représente l’état de la compilation à un certain point.

Syntaxe

/Yc
Fichier /Yc

Arguments

nom_fichier
Spécifie un fichier d’en-tête (.h). Lorsque cet argument est utilisé, le compilateur compile tout le code jusqu’au fichier .h et y compris.

Notes

Lorsque /Yc est spécifié sans argument, le compilateur compile tout le code jusqu’à la fin du fichier source de base ou au point dans le fichier de base où une directive hdrstop se produit. Le fichier .pch obtenu a le même nom de base que votre fichier source de base, sauf si vous spécifiez un autre nom de fichier à l’aide du pragma hdrstop ou de l’option /Fp .

Le code précompilé est enregistré dans un fichier avec un nom créé à partir du nom de base du fichier spécifié avec l’option /Yc et une extension .pch. Vous pouvez également utiliser / Fp (Nom. Option Fichier pch) pour spécifier un nom pour le fichier d’en-tête précompilé.

Si vous utilisez le nom de fichier /Yc, le compilateur compile tout le code jusqu’à l’option /Yu (Utiliser le fichier d’en-tête précompilé) et inclut le fichier spécifié pour une utilisation ultérieure.

Si les options /Ycfilename et /Yufilename se produisent sur la même ligne de commande et que les deux références, ou impliquent, le même nom de fichier, /Ycfilename est prioritaire. Cette fonctionnalité simplifie l’écriture de makefiles.

Pour plus d’informations sur les en-têtes précompilés, consultez :

Pour définir cette option du compilateur dans l'environnement de développement Visual Studio

  1. Sélectionnez un fichier .cpp. Le fichier .cpp doit #include le fichier .h qui contient des informations d’en-tête précompilées. Le paramètre /Yc du projet peut être remplacé au niveau du fichier.

  2. Ouvrez la boîte de dialogue Pages de propriété du projet. Pour plus d’informations, consultez Définir le compilateur C++ et les propriétés de build dans Visual Studio.

  3. Ouvrez la page de propriétés Propriétés de configuration, C/C++, Propriétés d’en-têtes précompilés.

  4. Modifiez la propriété Header précompilée.

  5. Pour définir le nom de fichier, modifiez la propriété Fichier d’en-tête précompilé.

Pour définir cette option du compilateur par programmation

Exemple

Prenez le code suivant :

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

Lorsque ce code est compilé avec la commande CL /YcMYAPP.H PROG.CPP, le compilateur enregistre tout le prétraitement pour AFXWIN.h, RESOURCE.h et MYAPP.h dans un fichier d’en-tête précompilé appelé MYAPP.pch.

Voir aussi

Options du compilateur MSVC
Syntaxe de la ligne de commande du compilateur MSVC
Fichiers d'en-tête précompilés