CheckOBJCXXSourceRuns

新增於 3.16 版本。

檢查給定的 Objective-C++ 原始碼是否能編譯並連結成可執行檔，並且可以執行一次。

check_objcxx_source_runs

check_objcxx_source_runs(<code> <resultVar>)

檢查在 <code> 中提供的原始碼是否能被建置、連結為可執行檔，然後執行。 <code> 必須至少包含一個 main() 函式。

結果會儲存在由 <resultVar> 指定的內部快取變數中。建置和執行成功會以布林值 true 表示。建置或執行失敗會以布林值 false 表示，例如空字串或錯誤訊息。

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

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

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