CheckCXXSourceCompiles

單次檢查 C++ 原始碼是否可以建置。

check_cxx_source_compiles

check_cxx_source_compiles(<code> <resultVar>
                          [FAIL_REGEX <regex1> [<regex2>...]])

單次檢查在 <code> 中提供的原始碼是否可以建置。結果會儲存在由 <resultVar> 指定的內部快取變數中，成功為布林值 true，失敗為布林值 false。

如果提供了 FAIL_REGEX，則透過檢查編譯器輸出中的任何內容是否符合任何指定的正規表示式來判斷失敗。

在內部，try_compile() 用於編譯原始碼。如果 CMAKE_TRY_COMPILE_TARGET_TYPE 設定為 EXECUTABLE (預設值)，則原始碼會編譯並連結為可執行程式。如果設定為 STATIC_LIBRARY，則原始碼會編譯但不會連結。在任何情況下，所有函式都必須照常宣告。

另請參閱 check_source_compiles() 以取得更通用的命令語法。

另請參閱 check_source_runs() 以執行編譯後的原始碼。

編譯和連結命令可以透過在呼叫 check_cxx_source_compiles() 之前設定以下任何變數來影響

CMAKE_REQUIRED_FLAGS

要傳遞給編譯器的其他旗標字串。字串必須以空格分隔--;-list 將無法運作。CMAKE_<LANG>_FLAGS 及其相關的組態特定變數的內容會自動新增到編譯器命令中，然後才是 CMAKE_REQUIRED_FLAGS 的內容。

CMAKE_REQUIRED_DEFINITIONS

;-list 形式為 -DFOO 或 -DFOO=bar 的編譯器定義。<resultVar> 指定的名稱的定義也會自動新增。

CMAKE_REQUIRED_INCLUDES

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

CMAKE_REQUIRED_LINK_OPTIONS

在 3.14 版本中新增。

;-list 要新增到連結命令的選項 (請參閱 try_compile() 以取得更多詳細資訊)。

CMAKE_REQUIRED_LIBRARIES

;-list 要新增到連結命令的函式庫。這些可以是系統函式庫的名稱，也可以是 匯入目標 (請參閱 try_compile() 以取得更多詳細資訊)。

CMAKE_REQUIRED_LINK_DIRECTORIES

在 3.31 版本中新增。

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

CMAKE_REQUIRED_QUIET

在 3.1 版本中新增。

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