次の方法で共有

/headerName (指定したヘッダーからヘッダー ユニットをビルドします)

  • [アーティクル]

指定されたヘッダー ファイルを、ヘッダー ユニット (.ifc ファイル) へとビルドします。

構文

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

引数

header-filename
コンパイラでヘッダー ユニット (.ifc ファイル) へとコンパイルするヘッダー ファイルの名前。

解説

/headerName:quoteおよび/headerName:angleコンパイラ オプションは、Visual Studio 2019 バージョン 16.10 以降で使用できます。

すべての形式の /headerName コンパイラ オプションには、 /std:c++20 以降のコンパイラ オプション ( /std:c++latest など) が必要です。
/headerName オプションを指定する場合は、/exportHeaderも指定する必要があります。

  • /headerName:quote の場合は、#include "header-filename" と同じ規則を使用して header-filename を参照し、それをヘッダー ユニット (.ifc ファイル) としてビルドします。
  • /headerName:angle の場合は、#include <header-filename> と同じ規則を使用して header-filename を参照し、それをヘッダー ユニット (.ifc ファイル) としてビルドします。

引用符または山かっこに含まれるファイルのパス検索規則の詳細については、「 #include ディレクティブを参照してください。

例

m.hと呼ばれるヘッダー ファイルを参照するプロジェクトでは、ヘッダー ユニットにコンパイルするコンパイラ オプションは次の例のようになります。

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

/headerName:quoteオプションと/headerName:angleオプションはフラグのように動作し、引数は必要ありません。 有効な例を次に示します。

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

同じコマンド ラインで複数の /headerName オプションを指定できます。 /headerName オプションの後のすべての引数は、次の/headerName オプションまで、引用符または山かっこのインクルード ファイル参照規則で処理されます。 次の例では、前の 2 つのコマンド ラインの例と同じ方法ですべてのヘッダーを処理します。 ヘッダーは、 #include <vector>、 #include <iostream>、 #include <algorithm>、 #include "my-utilties.h"、および #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

Visual Studio 開発環境でこのコンパイラ オプションを設定するには

Note

通常、Visual Studio 開発環境ではこのオプションを設定しないでください。 これはビルド システムによって設定されます。

  1. プロジェクトの [プロパティ ページ] ダイアログ ボックスを開きます。 詳細については、Visual Studio での C++ コンパイラとビルド プロパティの設定に関する記事を参照してください。

  2. [構成] ドロップダウンを [すべての構成] に設定します。 [プラットフォーム] ドロップダウンを [すべてのプラットフォーム] に設定します。

  3. [構成プロパティ]>[C/C++]>[コマンド ライン] プロパティ ページを選択します。

  4. Additional Options プロパティを変更して、/headerName:quoteまたは/headerName:angleオプションを追加し、オプションが適用されるヘッダー ファイル名を追加します。 その後、[OK] または [適用] を選択して、変更を保存します。

関連項目

/exportHeader (ヘッダー ユニットの作成)
/headerUnit (ヘッダー ユニット IFC の使用)
/reference (名前付きモジュール IFC の使用)
/translateInclude (インクルード ディレクティブをインポート ディレクティブに変換する)