CheckCSourceRuns¶
檢查給定的 C 原始碼是否可以編譯並連結成可執行檔,然後接著執行。
- check_c_source_runs¶
check_c_source_runs(<code> <resultVar>)
檢查
<code>
中提供的原始碼是否可以建置、連結為可執行檔,然後執行。<code>
必須至少包含一個main()
函式。結果會儲存在由
<resultVar>
指定的內部快取變數中。建置和執行成功會以布林值true
表示。建置或執行失敗會以布林值false
表示,例如空字串或錯誤訊息。另請參閱
check_source_runs()
以取得更通用的指令語法。編譯和連結指令可以透過在呼叫
check_c_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。這些可以是系統程式庫的名稱,也可以是 Imported Targets (詳見
try_compile()
)。
CMAKE_REQUIRED_LINK_DIRECTORIES
在版本 3.31 中新增。
要傳遞給連結器的程式庫搜尋路徑 ;-list (詳見
try_compile()
)。
CMAKE_REQUIRED_QUIET
在版本 3.1 中新增。
如果此變數評估為布林值 true,則會抑制與檢查相關的所有狀態訊息。