CheckOBJCXXCompilerFlag

在 3.16 版本中新增。

檢查 Objective-C++ 編譯器是否支援給定的旗標一次。

check_objcxx_compiler_flag

check_objcxx_compiler_flag(<flag> <resultVar>)

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

true 僅表示編譯器在給定旗標時未發出診斷訊息。旗標是否有任何作用超出此模組的範圍。

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

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

編譯和連結命令可以透過在呼叫 check_objcxx_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，則會隱藏與檢查相關的所有狀態訊息。