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

要傳遞給編譯器的額外旗標字串。字串必須以空格分隔——;-list 無效。CMAKE_<LANG>_FLAGS 及其相關的配置特定變數的內容，會自動添加到編譯器命令中，在 CMAKE_REQUIRED_FLAGS 的內容之前。

CMAKE_REQUIRED_DEFINITIONS

形式為 -DFOO 或 -DFOO=bar 的編譯器定義的 ;-list。也會自動添加由 <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，則會抑制與檢查關聯的所有狀態訊息。