/translateInclude

  • Artikel

Dieser Switch weist den Compiler an, als import Headerdateien zu behandeln#include, die in Headereinheitsdateien (.ifc) integriert wurden und die in der Befehlszeile angegeben /headerUnitsind.

Bei Verwendung mit /scanDependencies oder /sourceDependencies-directives, wird der Compiler als importierte Headereinheiten in der generierten Abhängigkeitsdatei aufgeführt, die sowohl in der Quelle enthalten sind als auch über einen entsprechenden Eintrag in einer header-units.json Datei verfügen. Diese Abhängigkeitsinformationen werden vom Buildsystem verwendet, um kompilierte Headereinheitsdateien .ifc zu generieren. Sobald die Headereinheiten erstellt wurden, werden sie vom Compiler als import anstelle eines #includeCompilers behandelt.

Die header-units.json Datei wird nur bei Angabe konsultiert /translateInclude . Weitere Informationen zum Format und Zweck der header-units.json Datei finden Sie unter header-units.json.

Wenn eine #include Datei nicht in der header-units.json Datei aufgeführt ist, wird sie normal #includebehandelt.

Ein Beispiel für die Verwendung dieser Option finden Sie unter Walkthrough: Build and import header units in Microsoft Visual C++.

Syntax

/translateInclude

Hinweise

/translateInclude ist in Visual Studio 2019, Version 16.10 oder höher, verfügbar.
/translateInclude erfordert /std:c++20 oder höher.

So legen Sie diese Compileroption in Visual Studio fest

Zum Aktivieren /translateIncludedes Dialogfelds "Projekteigenschaften" legen Sie "In Importe übersetzen" fest:

  1. Wählen Sie im linken Bereich der Projekteigenschaftenseiten die Option "Konfigurationseigenschaften>C/C++>Allgemein" aus.

  2. Ändern Sie die Dropdownliste "Übersetzung enthält in Importe " in "Ja".

    Screenshot of the Property Pages dialog with the Translate Includes to Imports property highlighted.

  3. Wählen Sie "OK" aus, oder "Übernehmen", um Ihre Änderungen zu speichern.

Siehe auch

/headerUnit (Verwenden Sie IFC der Kopfzeileneinheit.Use header unit IFC).
/exportHeader (Erstellen von Headereinheiten)
/reference (Verwenden des benannten Moduls IFC)
/scanDependencies
/sourceDependencies-directives
Exemplarische Vorgehensweise: Erstellen und Importieren von Headereinheiten in Microsoft Visual C++