/exportHeader （建立標頭單位）

  • 發行項

告知編譯程式建立輸入自變數所指定的標頭單位。 編譯程式會產生標頭單位作為 IFC （.ifc） 檔案。

語法

/exportHeader /headerName:angle header-name
/exportHeader /headerName:quote header-name
/exportHeader full path to header file

引數

的自變數 /exportHeader 是 /headerName 命令列選項，指定要匯出之頭檔的名稱 header-name。

備註

/exportHeader 從 Visual Studio 2019 16.10 版開始提供。

編譯 /exportHeader 程式選項需要您啟用 /std:c++20 或更新版本的編譯程式選項 （例如 /std:c++latest）。

一個 /exportHeader 編譯程式選項可以指定組建所需的多個標頭名稱自變數。 您不需要個別指定它們。

使用此選項時，編譯程式會隱含地啟用新的預處理器。 也就是說， /Zc:preprocessor 如果命令行上使用任何形式的 /exportHeader ，編譯程式就會新增至命令行。 若要選擇離開隱含 /Zc:preprocessor，請使用： /Zc:preprocessor-

根據預設，編譯程式不會在編譯標頭單位時產生物件檔。 若要產生物件檔，請指定 /Fo 編譯程序選項。 如需詳細資訊，請參閱 /Fo （物件檔案名） 。

您可能會發現使用互補選項 /showResolvedHeader會很有説明。 選項 /showResolvedHeader 會列印自變數所解析之檔案 header-name 的絕對路徑。

/exportHeader 可以一次處理多個輸入，即使在 下 /MP也是如此。 建議您使用 /ifcOutput <directory> 來為每個編譯建立個別 .ifc 的檔案。

範例

若要建置標頭單位，如下所示 <vector> ：

cl . . . /std:c++latest /exportHeader /headerName:angle vector

建置本機項目標頭，如下所示 "utils/util.h" ：

cl . . . /std:c++latest /exportHeader /headerName:quote util/util.h

在 Visual Studio 開發環境中設定這個編譯器選項

除非您對頭檔使用不同的擴展名，否則您通常不應該在 Visual Studio 開發環境中設定此選項。 根據預設，建置系統會將此選項套用至擴展名為或沒有擴展名的 .h 已編譯檔案。

  1. 若要在 IDE 中明確將 /exportHeader 選項套用至檔案，請選取 方案總管 中的檔案。 以滑鼠右鍵按鍵按下以開啟操作功能表，然後選取 [ 屬性] 以開啟 [屬性 頁] 對話框。

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

  3. 開啟 [組態屬性>C/C++][>進階] 屬性頁。

  4. 使用下拉式清單控制檔將 [編譯身分] 屬性修改為 [編譯為C++標頭單位 （/exportHeader） 。 選擇 [確定] 或 [套用] 以儲存變更。

另請參閱

/headerName （從指定的標頭建置標頭單位）
/headerUnit （使用標頭單位 IFC）
/reference （使用具名模組 IFC）
/translateInclude （將 include 指示詞轉譯為 import 指示詞）