Utilisation des en-têtes précompilés avec les compilateurs C++ améliorés par Clang
Remonter à Compilateurs C++ améliorés par Clang
Un fichier d'en-tête précompilé est un fichier d'en-tête C++ qui est précompilé afin d'accélérer son traitement lors de la compilation. Quand vous utilisez un compilateurs C++ améliorés par Clang, vos projets ne peuvent utiliser à la fois qu'un seul en-tête précompilé pour la précompilation. Quand vous utilisez un BCC32 ou BCCOSX, chacun de vos projets peut utiliser plusieurs en-têtes précompilés.
Sommaire
Le fichier PCH.h est le fichier d'en-tête précompilé par défaut pour les applications C++
Un en-tête précompilé est automatiquement généré pour chaque projet C++. Le nom par défaut du fichier d'en-tête précompilé généré est :
<projectname>PCH<n>.h
- <projectname> est le nom du projet pour lequel l'en-tête précompilé est créé.
- <n> est le numéro de l'en-tête précompilé.
Par exemple, quand vous créez une nouvelle application C++ nommée Projet1, l'en-tête précompilé suivant est automatiquement généré, quel que soit le compilateur utilisé pour construire ce projet :
Project1PCH1.h
Le fichier PCH.h est un noeud dans le Gestionnaire de projets pour chaque projet C++. L'en-tête précompilé généré automatiquement (le fichier PCH.h) est utilisé par défaut dans la compilation des applications C++ Windows 64 bits.
- Remarque : BCC32 et BCCOSX génèrent par défaut des en-têtes précompilés. Vous pouvez néanmoins les configurer en utilisant le fichier
PCH.h
affiché dans le Gestionnaire de projets si vous incluez () simplement le fichier#include
PCH.h
(suivi de#pragma hdrstop;
) dans chaque fichier source de votre projet. Vous devrez bien entendu éditer le contenu du fichierPCH.h
pour inclure () tous les en-têtes nécessaires à votre projet.#include
Création d'un en-tête précompilé pour les compilateurs C++ améliorés par Clang
La procédure suivante montre comment utiliser les en-têtes précompilés pour les compilateurs C++ améliorés par Clang. Ces compilateurs n'acceptent qu'un seul fichier d'en-tête par projet. En suivant les étapes ci-dessous, vous allez créer le fichier d'en-tête unique et l'utiliser en tant qu'en-tête précompilé pour un fichier source.
Etapes
- Créez une application C++ (Application console, VCL ou FireMonkey).
- Vous pouvez utiliser une nouvelle application ou une application créée dans une version de C++Builder antérieure à XE3. Ainsi, il est possible que vous ayez apporté des changements et des additions à l'application depuis sa création, ou il peut s'agir d'une ancienne application créée dans une version précédente de C++Builder.
- Sélectionnez Fichier > Tout enregistrer. Enregistrez tous les fichiers du projet à un emplacement désiré.
- Dans le Gestionnaire de projets, activez la plate-forme cible utilisant un compilateur C++ amélioré par Clang (telle que Windows 64 bits) et le fichier PCH :
- Cliquez avec le bouton droit sur Plates-formes cible, sélectionnez Ajouter une plate-forme puis la plate-forme cible.
- Cliquez avec le bouton droit sur le fichier PCH.h de votre projet et assurez-vous que l'option Utiliser pour la précompilation est activée.
- Editez le fichier d'en-tête PCH.h et incluez les fichiers d'en-têtes que vous voulez précompiler. Le fichier PCH.h doit se terminer par :
#pragma hdrstop
- Enregistrez le fichier PCH.h dans le dossier du projet.
- Dans le Gestionnaire de projets, cliquez avec le bouton droit sur le fichier source dans lequel vous voulez inclure l'en-tête précompilé PCH.h, et sélectionnez Modifier les options locales sur le menu contextuel.
- Appuyez sur F9 pour exécuter le projet.
Voici la ligne de commande BCC64 pour le fichier source pour lequel l'en-tête précompilé est défini. Notez l'option de ligne de commande qui inclut un en-tête précompilé dans un fichier source (-include-pch
) :