共用方式為

/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 的每個自變數都會使用指定的 include 檔案查閱規則來處理引號或角括弧，直到下一 /headerName 個選項為止。 下列範例會以與先前相同的方式，將所有標頭處理為前兩個命令行範例。 它會使用套用的查閱規則來查閱標頭，如同已指定為： #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 開發環境中設定這個編譯器選項

注意

您通常不應該在 Visual Studio 開發環境中設定此選項。 它是由建置系統所設定。

  1. 開啟專案的 [屬性頁] 對話方塊。 如需詳細資料，請參閱在 Visual Studio 中設定 C ++ 編譯器和組建屬性。

  2. 將 [ 組態 ] 下拉式清單設定為 [所有組態]。 將 [平台] 下拉式值設定為 [所有平台]。

  3. 選取 [組態屬性]>[C/C++]>[命令列] 屬性頁。

  4. 修改 [其他選項] 屬性，以新增 /headerName:quote 或 /headerName:angle 選項，以及選項所套用的標頭檔名。 然後選擇 [確定] 或 [套用] 以儲存變更。

另請參閱

/exportHeader （建立標頭單位）
/headerUnit （使用標頭單位 IFC）
/reference （使用具名模組 IFC）
/translateInclude （將 include 指示詞轉譯為 import 指示詞）