/ifcMap

此參數會告訴編譯程式要在哪裡尋找 IFC 參考對應檔，這會將具名模組和標頭單位的參考對應至其對應的 IFC （.ifc） 檔案。

語法

/ifcMap filename

備註

自 *filename* 變數會指定IFC參考對應檔。 它可以相對於編譯程式的工作目錄或絕對路徑。

您可以為編譯程式提供多個 /ifcMap 自變數。

IFC 參考對應檔格式是 TOML 檔格式的子集。 IFC 參考對應檔可以包含 混合 [[module]] 和 [[header-unit]] 參考。

語法錯誤或無法辨識的數據表名稱會導致編譯程式錯誤 C7696 （TOML 剖析錯誤）。

對應具名模組

具名模組的 IFC 參考對應檔格式為：

# Using literal strings
[[module]]
name = 'M'
ifc = 'C:\modules\M.ifc'

# Using basic strings
[[module]]
name = "N"
ifc = "C:\\modules\\N.ifc"

這個 IFC 參考對應檔會將具名模組 'M' 和 'N' 對應至其各自的 IFC 檔案。 對等 的 '/reference' 為：

/reference M=C:\modules\M.ifc /reference N=C:\modules\N.ifc

如需哪些模組名稱類型對 name 欄位有效的詳細資訊，請參閱 /reference remarks。

地圖標頭單位

標頭單位的 IFC 參考對應檔格式為：

# Using literal strings
[[header-unit]]
name = ['quote', 'my-utility.h']
ifc = 'C:\header-units\my-utility.h.ifc'

[[header-unit]]
name = ['angle', 'vector']
ifc = 'C:\header-units\vector.ifc'

# Using basic strings
[[header-unit]]
name = ["quote", "my-engine.h"]
ifc = "C:\\header-units\\my-engine.h.ifc"

[[header-unit]]
name = ["angle", "algorithm"]
ifc = "C:\\header-units\\algorithm.ifc"

這個 IFC 參考對應檔會對應 "my-utility.h" 至 C:\header-units\my-utility.h.ifc、 和 <vector> ， C:\header-units\vector.ifc等等。 對等 /headerUnit 專案為：

/headerUnit:quote my-utility=C:\header-units\my-utility.h.ifc /headerUnit:angle vector=C:\header-units\vector.ifc /headerUnit:quote my-engine.h=C:\header-units\my-engine.h.ifc /headerUnit:angle algorithm=C:\header-units\algorithm.ifc

當 在 IFC 參考對應檔中指定 時 [[header-unit]] ，編譯程式會隱含地啟用 /Zc:preprocessor，就像使用 時 /headerUnit 隱含啟用一樣。 如需 和 quote 查閱方法行為angle的詳細資訊，請參閱 /headerUnit 備註。

另請參閱

C++ 中的模組概觀
逐步解說：在 Visual C++ 專案中建置和匯入標頭單位
從命令行使用 MSVC 中的C++模組