CheckFortranSourceCompiles

版本 3.1 新增。

單次檢查 Fortran 原始碼是否可以被建置。

check_fortran_source_compiles
check_fortran_source_compiles(<code> <resultVar>
    [FAIL_REGEX <regex>...]
    [SRC_EXT <extension>]
)

單次檢查在 <code> 中提供的原始碼是否可以被建置。結果會儲存在由 <resultVar> 指定的內部快取變數中,成功為布林值 true,失敗為布林值 false

如果提供 FAIL_REGEX,則會透過檢查編譯器輸出中是否有任何內容符合指定的正規表示式來判斷失敗。

預設情況下,測試原始檔將被賦予 .F 副檔名。可以使用 SRC_EXT 選項來覆蓋此設定,改為使用 .<extension> -- .F90 是一個典型的選擇。

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

另請參閱 check_source_runs() 以執行已編譯的原始碼。

在內部,try_compile() 用於編譯原始碼。如果 CMAKE_TRY_COMPILE_TARGET_TYPE 設定為 EXECUTABLE (預設值),則原始碼會被編譯並連結為可執行程式。如果設定為 STATIC_LIBRARY,則原始碼只會被編譯而不會被連結。在任何情況下,所有函式都必須照常宣告。

編譯和連結命令可以透過在呼叫 check_fortran_source_compiles() 之前設定以下任何變數來影響。

CMAKE_REQUIRED_FLAGS

要傳遞給編譯器的額外旗標字串。該字串必須以空格分隔 -- ;-list 無效。CMAKE__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,則所有與檢查相關的狀態訊息都將被抑制。