CheckIncludeFiles

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

CHECK_INCLUDE_FILES

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

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

如果設定了 LANGUAGE，將使用指定的編譯器執行檢查。 可接受的值為 C 和 CXX。 如果未設定，如果啟用了 C 編譯器，則將使用 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 語言中的單個標頭檔。