Options de ligne de commande des en-têtes précompilés pour BCC32

De RAD Studio
Aller à : navigation, rechercher

Remonter à BCC32.EXE, le compilateur C++ 32 bits en ligne de commande


Les fichiers d'en-têtes précompilés accélèrent de façon significative la vitesse de compilation en stockant une image de la table des symboles dans un fichier sur disque. Ce fichier est ensuite rechargé au lieu d'analyser de nouveau tous les fichiers d'en-têtes. Le chargement direct de la table des symboles depuis le disque est beaucoup plus rapide que l'analyse du texte des fichiers d'en-têtes, en particulier si plusieurs fichiers source incluent le même fichier d'en-tête.

Pour utiliser les fichiers en-tête précompilés sur la ligne de commande, spécifiez les diverses options -H dans votre commande BCC32.

Options des en-têtes précompilés :

Option du compilateur Description Détails
-H

Générer et utiliser

Lorsque vous activez cette option, le compilateur génère et utilise les en-têtes précompilés. Le nom de fichier par défaut de l'en-tête précompilé généré est BC32DEF.CSM pour le compilateur en ligne de commande.

Pour spécifier un en-tête précompilé, utilisez :

-H=myhdrfile.h

Pour activer l'en-tête précompilé pour un fichier source particulier, utilisez :

-H File2.cpp
-Hu

Utiliser mais ne pas générer

Lorsque vous activez cette option, le compilateur utilise les fichiers en-tête précompilés et pré-existants ; de nouveaux fichiers en-tête précompilés ne sont pas générés.

-H-

Ne pas générer, ni utiliser

Lorsque vous activez cette option, le compilateur ne génère pas, ni n'utilise les en-têtes précompilés. Par défaut : Ne génère pas, ni n'utilise (-H-)

-Hc

En-têtes précompilés en cache

Lorsque vous activez cette option, le compilateur met en mémoire cache les en-têtes précompilés qu'il génère. Cette option sert lors de la précompilation de plusieurs fichiers en-tête. Pour utiliser cette option, vous devez également activer l'option Générer et utiliser (-H) concernant les en-têtes précompilés. Par défaut, cette option est désactivée.

-He

Générer les fichiers de type externe (en-têtes précompilés)

Lorsque vous activez cette option, le compilateur génère un fichier (ou des fichiers) contenant les informations de débogage pour tous les symboles contenus dans les en-têtes précompilés. Les noms de fichiers se terminent par l'extension .#xx, où xx vaut 00 pour le premier fichier généré, sa valeur augmentant pour chaque fichier d'informations de type supplémentaire. L'utilisation de cette option diminue considérablement la taille de vos fichiers .OBJ, puisque les informations de débogage sont centralisées et non dupliquées dans chaque fichier .OBJ. Par défaut, cette option est activée.

-H=myhdrfile.h

Nom de fichier en-tête précompilé

Utilisez cette option pour spécifier le nom de votre fichier en-tête précompilé. Lorsque vous définissez cette option, le compilateur génère et utilise le fichier en-tête précompilé que vous spécifiez.

-Hh=<xxx>

ou

-H\"<xxx>\"

Arrêter la précompilation après le fichier en-tête

Cette option termine la compilation de l'en-tête précompilé après avoir traité le fichier spécifié par xxx. Vous pouvez utiliser cette option pour réduire l'espace disque requis pour les en-têtes précompilés.

La syntaxe -Hh est généralement plus facile à utiliser que la syntaxe -H. Exemples :

-Hh=myhdrfile.h 
-H\"myhdrfile.h\" 
-Hh="C:\Program Files\myhdrfile.h" 
-H\"C:\Program Files\myhdrfile.h\"
  • Lorsque vous utilisez cette option, le fichier que vous spécifiez doit être inclus à partir d'un fichier source pour que le compilateur génère un fichier en-tête précompilé.
  • Vous pouvez également utiliser #pragma hdrstop dans votre fichier source afin de spécifier à quel moment arrêter la génération des en-têtes précompilés.
  • Vous ne pouvez pas spécifier un fichier d'en-tête inclus à partir d'un autre fichier d'en-tête. Par exemple, vous ne pouvez pas lister un en-tête inclus par windows.h car cela aurait pour effet de provoquer la fermeture du fichier en-tête précompilé avant que ne s'achève la compilation de windows.h.
-Hi myhdrfile.h

Injecte le contenu du fichier en-tête

Lorsque vous spécifiez cette option, BCC32 inclut le contenu du fichier en-tête spécifié et inclut d'abord le fichier en-tête spécifié.

La combinaison de -Hh et -Hi est équivalente à l'ajout des directives suivantes au début de chaque fichier .cpp :

 #include "myhdrfile.h"
 #pragma hdrstop


Voir aussi