Partager via


/translateInclude

Ce commutateur indique au compilateur de traiter #include comme import pour les fichiers d’en-tête qui ont été intégrés aux fichiers d’unité d’en-tête (.ifc) et spécifiés sur la ligne de commande avec /headerUnit.

Lorsqu’il est utilisé avec /scanDependencies ou /sourceDependencies-directives, le compilateur répertorie comme unités d’en-tête importées dans le fichier de dépendance généré ces en-têtes qui sont tous les deux inclus dans la source et ont une entrée correspondante dans un header-units.json fichier. Ces informations de dépendance sont utilisées par le système de génération pour générer des fichiers d’unité .ifc d’en-tête compilés. Une fois les unités d’en-tête générées, elles sont traitées par le compilateur comme un import élément au lieu d’un #include.

Le header-units.json fichier est consulté uniquement lorsqu’il /translateInclude est spécifié. Pour plus d’informations sur le format et l’objectif du header-units.json fichier, consultez header-units.json.

Si un #include fichier n’est pas répertorié dans le header-units.json fichier, il est traité comme un fichier normal #include.

Pour obtenir un exemple de l’utilisation de ce commutateur, consultez Procédure pas à pas : Générer et importer des unités d’en-tête dans Microsoft Visual C++.

Syntaxe

/translateInclude

Notes

/translateInclude est disponible dans Visual Studio 2019 version 16.10 ou ultérieure.
/translateInclude nécessite /std :c++20 ou version ultérieure.

Pour définir cette option de compilateur dans Visual Studio

Pour activer /translateInclude, dans la boîte de dialogue propriétés du projet, définissez Translate Includes en importations :

  1. Dans le volet gauche des pages de propriétés du projet, sélectionnez Propriétés>de configuration C/C++>Général.

  2. Modifiez la liste déroulante Translate Includes to Imports sur Oui.

    Capture d’écran de la boîte de dialogue Pages de propriétés avec la propriété Translate Includes to Imports mise en surbrillance.

  3. Choisissez OK ou Appliquer pour enregistrer vos modifications.

Voir aussi

/headerUnit (Utiliser l’unité d’en-tête IFC).
/exportHeader (Créer des unités d’en-tête)
/reference (Utiliser le module NOMMÉ IFC)
/scanDependencies
/sourceDependencies-directives
Procédure pas à pas : Générer et importer des unités d’en-tête dans Microsoft Visual C++