CheckCXXCompilerFlag

檢查 CXX 編譯器是否支援給定的旗標 (flag)。

check_cxx_compiler_flag

check_cxx_compiler_flag(<flag> <var>)

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

true 僅表示編譯器在給定該旗標時沒有發出診斷訊息。該旗標是否產生任何效果不在本模組的範圍內。

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

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

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

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，則會抑制與檢查相關的所有狀態訊息。