/translateInclude

このスイッチを使用すると、ヘッダー ユニット (.ifc) ファイルに組み込まれ、コマンド ラインで /headerUnit が指定されたヘッダー ファイルについて #includeimport として処理するようにコンパイラに指示します。

/scanDependencies または /sourceDependencies-directives と共に使用すると、コンパイラによって、生成された依存関係ファイル内のインポートされたヘッダー ユニットとして一覧表示されます。これらのヘッダーは、どちらもソースに含まれ、header-units.json ファイル内に対応するエントリがあります。 この依存関係情報は、コンパイル済みヘッダー ユニットの .ifc ファイルを生成するために、ビルド システムによって使用されます。 ヘッダー ユニットが構築されると、コンパイラによって #include ではなく、import として扱われます。

/translateInclude が指定されている場合にのみ、header-units.json ファイルが参照されます。 header-units.json ファイルの形式と目的の詳細については、header-units.json に関するページを参照してください。

#include ファイルが header-units.json ファイルに一覧表示されいない場合は、通常の #include として扱われます。

このスイッチの使用方法の例については、「チュートリアル: Microsoft Visual C++ でヘッダー ユニットをビルドしてインポートする」を参照してください。

構文

/translateInclude

解説

/translateInclude は Visual Studio 2019 バージョン 16.10 以降で使用できます。
/translateInclude には /std:c++20 以降が必要です。

このコンパイラ オプションを Visual Studio で使用するには

/translateInclude を有効にするには、プロジェクトのプロパティ ダイアログで [Translate Includes to Imports]\(インクルードをインポートに変換\) を次のように設定します。

  1. プロジェクトのプロパティ ページの左側のペインで、[構成プロパティ] > [C/C++] > [全般] を選択します。

  2. [インクルードをインポートに変換] ドロップダウンを [はい] に変更します。

    [インポートに含める変換] プロパティが強調表示されている [プロパティ ページ] ダイアログのスクリーンショット。

  3. [OK] または [適用] を選択して、変更内容を保存します。

関連項目

/headerUnit (ヘッダー ユニット IFC の使用)
/exportHeader (ヘッダー ユニットの作成)
/reference (名前付きモジュール IFC の使用)
/scanDependencies
/sourceDependencies-directives
チュートリアル: Microsoft Visual C++ でヘッダー ユニットをビルドしてインポートする