CheckCXXSourceRuns

檢查給定的 C++ 原始碼是否可以編譯並連結成可執行檔，並接著執行。

check_cxx_source_runs

check_cxx_source_runs(<code> <resultVar>)

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

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

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

編譯和連結指令可以透過在呼叫 check_cxx_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，則會抑制所有與檢查相關的狀態訊息。