CheckCSourceRuns

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

check_c_source_runs

check_c_source_runs(<code> <resultVar>)

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

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

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

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

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 。這些可以是系統函式庫的名稱，或者它們可以是 Imported Targets (詳情請參閱 try_compile() )。

CMAKE_REQUIRED_LINK_DIRECTORIES

在版本 3.31 中新增。

要傳遞給連結器的函式庫搜尋路徑的 ;-list (詳情請參閱 try_compile() )。

CMAKE_REQUIRED_QUIET

在版本 3.1 中新增。

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