CheckIncludeFiles

提供一個巨集來檢查是否可以一起包含一個或多個標頭檔的列表。

check_include_files

check_include_files("<includes>" <variable> [LANGUAGE <language>])

檢查給定的 <includes> 列表是否可以一起包含在源文件中，並將結果儲存在名為 <variable> 的內部快取條目中。將 <includes> 參數指定為標頭檔名稱的 ;-列表。

如果設定了 LANGUAGE，將使用指定的編譯器來執行檢查。可接受的值為 C 和 CXX。如果未設定，則在啟用 C 編譯器的情況下將使用 C 編譯器。如果未啟用 C 編譯器，則在啟用的情況下將使用 C++ 編譯器。

可以在呼叫此巨集之前設定以下變數，以修改檢查的執行方式

CMAKE_REQUIRED_FLAGS

要傳遞給編譯器的其他旗標字串。該字串必須以空格分隔——;-列表 將不起作用。CMAKE_<LANG>_FLAGS 及其相關的特定於組態變數的內容將自動添加到編譯器命令中，然後才是 CMAKE_REQUIRED_FLAGS 的內容。

CMAKE_REQUIRED_DEFINITIONS

;-列表 形式為 -DFOO 或 -DFOO=bar 的編譯器定義。還將自動添加由 <resultVar> 指定名稱的定義。

CMAKE_REQUIRED_INCLUDES

;-列表 要傳遞給編譯器的標頭搜尋路徑。這些將是唯一使用的標頭搜尋路徑——INCLUDE_DIRECTORIES 目錄屬性的內容將被忽略。

CMAKE_REQUIRED_LINK_OPTIONS

在版本 3.14 中新增。

;-列表 要添加到連結命令的選項（請參閱 try_compile() 以取得更多詳細資訊）。

CMAKE_REQUIRED_LIBRARIES

;-列表 要添加到連結命令的程式庫。這些可以是系統程式庫的名稱，也可以是 匯入目標（請參閱 try_compile() 以取得更多詳細資訊）。

CMAKE_REQUIRED_LINK_DIRECTORIES

在版本 3.31 中新增。

;-列表 要傳遞給連結器的程式庫搜尋路徑（請參閱 try_compile() 以取得更多詳細資訊）。

CMAKE_REQUIRED_QUIET

在版本 3.1 中新增。

如果此變數評估為布林值 true，則將抑制與檢查關聯的所有狀態訊息。

請參閱模組 CheckIncludeFile 和 CheckIncludeFileCXX，以檢查 C 或 CXX 語言中的單個標頭檔。