/headerName (Générer une unité d’en-tête à partir de l’en-tête spécifié)

  • Article

Générez le fichier d’en-tête spécifié dans une unité d’en-tête (.ifc fichier).

Syntaxe

/headerName:quote header-filename
/headerName:angle header-filename

Arguments

header-filename
Nom d’un fichier d’en-tête que le compilateur doit compiler dans une unité d’en-tête (.ifc fichier).

Notes

Les /headerName:quote options du compilateur sont /headerName:angle disponibles à partir de Visual Studio 2019 version 16.10.

Les /headerName options du compilateur, dans tous leurs formulaires, nécessitent l’option /std:c++20 de compilateur ou ultérieure (par /std:c++latestexemple).
Si vous spécifiez une /headerName option, vous devez également spécifier /exportHeader.

  • /headerName:quoteheader-filename recherche à l’aide des mêmes règles que #include "header-filename" et les génère en tant qu’unité d’en-tête (.ifcfichier).
  • /headerName:angleheader-filename recherche à l’aide des mêmes règles que #include <header-filename> et les génère en tant qu’unité d’en-tête (.ifcfichier).

Pour plus d’informations sur les règles de recherche de chemin d’accès pour les fichiers inclus entre guillemets ou crochets d’angle, consultez #include la directive.

Exemples

Étant donné un projet qui référence un fichier d’en-tête qu’il définit appelé m.h, l’option du compilateur pour la compiler dans une unité d’en-tête ressemble à cet exemple :

cl /std:c++latest /exportHeader /headerName:quote m.h /Fom.h.obj

Les /headerName:quote options et /headerName:angle agissent comme un indicateur et n’ont pas besoin d’un argument. Les exemples suivants sont valides :

cl /std:c++latest /exportHeader /headerName:angle /MP /Fo.\ vector iostream algorithm
cl /std:c++latest /exportHeader /headerName:quote /MP /Fo.\ my-utilities.h a/b/my-core.h

Vous pouvez spécifier plusieurs /headerName options sur la même ligne de commande. Chaque argument après qu’une /headerName option est traitée avec les règles de recherche de fichier spécifiées pour les guillemets ou crochets d’angle jusqu’à l’option suivante /headerName . L’exemple suivant traite tous les en-têtes comme les deux exemples de ligne de commande précédents de la même façon que précédemment. Il recherche les en-têtes à l’aide des règles de recherche appliquées comme s’ils avaient été spécifiés comme suit : #include <vector>, , #include <iostream>#include <algorithm>, #include "my-utilties.h", et #include "a/b/my-core.h":

cl /std:c++latest /exportHeader /headerName:angle /MP /Fo.\ vector iostream algorithm /headerName:quote my-utilities.h a/b/my-core.h

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

Remarque

Vous ne devez normalement pas définir cette option dans l’environnement de développement Visual Studio. Il est défini par le système de build.

  1. Ouvrez la boîte de dialogue Pages de propriété du projet. Pour plus d’informations, consultez Définir le compilateur C++ et les propriétés de build dans Visual Studio.

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

  3. Sélectionnez la page de propriétés Propriétés de configuration>C/C++>Ligne de commande.

  4. Modifiez la propriété Options supplémentaires pour ajouter les /headerName:quote ou /headerName:angle les options et les noms de fichiers d’en-tête dont les options s’appliquent. Ensuite, choisissez OK ou Appliquer pour enregistrer vos modifications.

Voir aussi

/exportHeader (Créer des unités d’en-tête)
/headerUnit (Utiliser l’unité d’en-tête IFC)
/reference (Utiliser le module NOMMÉ IFC)
/translateInclude (Traduire les directives include en directives d’importation)