/exportHeader (Créer des unités d’en-tête)

  • Article

Indique au compilateur de créer les unités d’en-tête spécifiées par les arguments d’entrée. Le compilateur génère des unités d’en-tête en tant que fichiers IFC (.ifc).

Syntaxe

/exportHeader /headerName:angle header-name
/exportHeader /headerName:quote header-name
/exportHeader full path to header file

Arguments

L’argument à /exportHeader utiliser est une /headerName option de ligne de commande qui spécifie le nom, header-namedu fichier d’en-tête à exporter.

Notes

/exportHeader est disponible à partir de Visual Studio 2019 version 16.10.

L’option /exportHeader du compilateur nécessite l’activation de l’option de /std:c++20 compilateur ou ultérieure (par /std:c++latestexemple).

Une /exportHeader option de compilateur peut spécifier autant d’arguments de nom d’en-tête que votre build nécessite. Vous n’avez pas besoin de les spécifier séparément.

Le compilateur active implicitement le nouveau préprocesseur lorsque cette option est utilisée. Autrement dit, /Zc:preprocessor est ajouté à la ligne de commande par le compilateur si une forme quelconque /exportHeader est utilisée sur la ligne de commande. Pour refuser l’implicite /Zc:preprocessor, utilisez : /Zc:preprocessor-

Par défaut, le compilateur ne produit pas de fichier objet lorsqu’une unité d’en-tête est compilée. Pour produire un fichier objet, spécifiez l’option du /Fo compilateur. Pour plus d’informations, consultez /Fo (Nom du fichier objet).

Vous pouvez trouver utile d’utiliser l’option /showResolvedHeadercomplémentaire. L’option /showResolvedHeader imprime un chemin d’accès absolu au fichier vers lequel l’argument header-name est résolu.

/exportHeader peut gérer plusieurs entrées à la fois, même sous /MP. Nous vous recommandons /ifcOutput <directory> de créer un fichier distinct .ifc pour chaque compilation.

Exemples

Pour générer une unité d’en-tête telle que celle-ci <vector> peut ressembler à ceci :

cl . . . /std:c++latest /exportHeader /headerName:angle vector

La création d’un en-tête de projet local, par "utils/util.h" exemple , peut ressembler à ceci :

cl . . . /std:c++latest /exportHeader /headerName:quote util/util.h

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

Vous ne devez normalement pas définir cette option dans l’environnement de développement Visual Studio, sauf si vous utilisez une autre extension pour vos fichiers d’en-tête. Par défaut, le système de build applique cette option aux fichiers compilés qui ont une .h extension ou aucune extension.

  1. Pour appliquer l’option /exportHeader à un fichier explicitement dans l’IDE, sélectionnez le fichier dans Explorateur de solutions. Cliquez avec le bouton droit pour ouvrir le menu contextuel et sélectionnez Propriétés pour ouvrir la boîte de dialogue Pages de propriétés.

  2. Définissez la liste déroulante Configuration sur Toutes les configurations. Définissez la liste déroulante Plateforme sur Toutes les plateformes.

  3. Ouvrez la page des propriétés>de configuration C/C++>Advanced.

  4. Utilisez le contrôle de liste déroulante pour modifier la propriété Compile as pour compiler en tant qu’unité d’en-tête C++ (/exportHeader). Choisissez OK ou Appliquer pour enregistrer vos modifications.

Voir aussi

/headerName (Générer une unité d’en-tête à partir de l’en-tête spécifié)
/headerUnit (Utiliser l’unité d’en-tête IFC)
/reference (Utiliser le module NOMMÉ IFC)
/translateInclude (Traduire les directives include en directives d’importation)