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

  • [アーティクル]

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

構文

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

引数

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

解説

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

コンパイラ オプションには /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:angleオプションは/headerName:quoteフラグのように動作し、引数は必要ありません。 有効な例を次に示します。

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

関連項目

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