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

 

Pour obtenir la dernière documentation sur Visual Studio 2017, consultez Documentation Visual Studio 2017.

Prescrit au compilateur de créer un fichier d'en-tête précompilé (.pch) qui représente l'état de la compilation à un moment donné.

/Yc[filename]  

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

Lorsque /Yc est spécifié sans argument, le compilateur compile tout le code jusqu'à la fin du fichier source de base, ou jusqu'à ce qu'il rencontre hdrstop dans ce fichier de base. Le fichier .pch résultant a le même nom de base que votre fichier source de base, sauf si vous spécifiez un nom de fichier différent en utilisant le pragma hdrstop ou l'option /Fp.

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

Si vous utilisez /Ycfilename, le compilateur compile tout le code jusqu'au fichier spécifié (inclus) pour toute utilisation ultérieure avec l'option /Yu.

Si les options /Ycfilename et /Yu (Utiliser un fichier d'en-tête précompilé)filename se produisent sur la même ligne de commande et font toutes les deux référence à un nom de fichier identique (ou l'impliquent), /Ycfilename prend la priorité. 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 comprendre (#include) le fichier .h qui contient des informations d'en-tête précompilées. Le paramètre /Yc du projet peut être substitué au niveau du fichier.

  2. Ouvrez la boîte de dialogue Pages de propriété du projet. Pour plus d'informations, consultez Comment : ouvrir les pages de propriétés d'un projet.

  3. Cliquez sur le dossier C/C++.

  4. Cliquez sur la page de propriétés En-têtes précompilés.

  5. Modifiez la propriété Création/utilisation d'un en-tête précompilé en spécifiant un nom de fichier ou la propriété Création/utilisation d'un en-tête précompilé.

Pour définir cette option du compilateur par programmation

Examinons le code ci-dessous.

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

Options du compilateur
Définition des options du compilateur

Afficher: