CheckCompilerFlag

於 3.19 版本新增。

檢查 <lang> 編譯器是否支援指定的旗標，僅檢查一次。

check_compiler_flag

check_compiler_flag(<lang> <flag> <resultVar>)

檢查 <flag> 是否被 <lang> 編譯器接受，且不產生診斷訊息。結果會儲存在由 <resultVar> 指定的內部快取變數中，成功時為布林值 true，失敗時為布林值 false。

true 僅表示編譯器在接收到旗標時沒有發出診斷訊息。此旗標是否有任何實際效果不在此模組的範圍內。

內部使用 try_compile() 來執行檢查。如果 CMAKE_TRY_COMPILE_TARGET_TYPE 設定為 EXECUTABLE（預設），則檢查會編譯並連結一個可執行程式。如果設定為 STATIC_LIBRARY，則檢查會編譯但不連結。

編譯和連結命令可以通過在呼叫 check_compiler_flag() 之前設定以下任何變數來影響。這些變數中未知的旗標可能會導致誤判的結果。

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。這些可以是系統函式庫的名稱，也可以是匯入目標（詳情請參閱 try_compile()）。

CMAKE_REQUIRED_LINK_DIRECTORIES

於 3.31 版本新增。

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

CMAKE_REQUIRED_QUIET

於 3.1 版本新增。

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