/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.

   

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++