CheckFunctionExists¶

檢查系統函式庫是否可以連結 C 函式一次。

check_function_exists¶

check_function_exists(<function> <variable>)

檢查系統函式庫是否提供 <function>，並將結果儲存在內部快取變數 <variable> 中。

在呼叫此巨集之前，可以設定以下變數來修改檢查的執行方式

CMAKE_REQUIRED_FLAGS
要傳遞給編譯器的額外旗標字串。字串必須以空格分隔——;-清單將不起作用。CMAKE_<LANG>_FLAGS 及其相關的組態特定變數的內容會自動加入到編譯器命令中，然後才是 CMAKE_REQUIRED_FLAGS 的內容。

CMAKE_REQUIRED_DEFINITIONS
;-清單形式為 -DFOO 或 -DFOO=bar 的編譯器定義。也會自動加入由 <resultVar> 指定名稱的定義。

CMAKE_REQUIRED_INCLUDES
;-清單要傳遞給編譯器的標頭搜尋路徑。這些將是唯一使用的標頭搜尋路徑——INCLUDE_DIRECTORIES 目錄屬性的內容將被忽略。

CMAKE_REQUIRED_LINK_OPTIONS

在版本 3.14 中新增。

;-清單要加入到連結命令的選項（請參閱 try_compile() 以取得更多詳細資訊）。

CMAKE_REQUIRED_LIBRARIES
;-清單要加入到連結命令的函式庫。這些可以是系統函式庫的名稱，也可以是匯入目標（請參閱 try_compile() 以取得更多詳細資訊）。

CMAKE_REQUIRED_LINK_DIRECTORIES

在版本 3.31 中新增。

;-清單要傳遞給連結器的函式庫搜尋路徑（請參閱 try_compile() 以取得更多詳細資訊）。

CMAKE_REQUIRED_QUIET

在版本 3.1 中新增。

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

注意

基於以下原因，建議使用 CheckSymbolExists 或 CheckSourceCompiles 模組，而不是此模組