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