CheckOBJCXXSourceCompiles

於 3.16 版本新增。

檢查 Objective-C++ 原始碼是否可以被建置。

check_objcxx_source_compiles

check_objcxx_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_objcxx_source_compiles() 之前設定以下任何變數來影響。

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，則與檢查相關的所有狀態訊息將被抑制。