CheckCXXCompilerFlag

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

check_cxx_compiler_flag

check_cxx_compiler_flag(<flag> <resultVar>)

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

true 僅表示當給定 flag (編譯選項) 時，編譯器沒有發出錯誤訊息。至於 flag (編譯選項) 是否有任何作用，則超出本模組的範圍。

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

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

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

CMAKE_REQUIRED_FLAGS

要傳遞給編譯器的額外 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，則所有與檢查相關聯的狀態訊息都將被抑制。