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

  • Article

Mise à jour : novembre 2007

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.

/Yc[filename]

Arguments

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

Notes

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 programme

Exemple

Prenons le code suivant :

#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

Référence

Options du compilateur

Définition des options du compilateur