CheckOBJCCompilerFlag

加入於版本 3.16。

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

check_objc_compiler_flag
check_objc_compiler_flag(<flag> <resultVar>)

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

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

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

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

編譯和連結命令可以透過在呼叫 check_objc_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,則與檢查相關的所有狀態訊息都將被抑制。