CheckFortranSourceRuns

新增於 3.14 版本。

檢查給定的 Fortran 原始碼是否能編譯並連結成可執行檔,且後續可執行。

check_fortran_source_runs
check_fortran_source_runs(<code> <resultVar>
    [SRC_EXT <extension>])

檢查一次在 <code> 中提供的原始碼是否可以被建置、連結為可執行檔,然後執行。 <code> 必須包含 Fortran program

結果會儲存在由 <resultVar> 指定的內部快取變數中。建置和執行成功會以布林值 true 表示。建置或執行失敗則以布林值 false 表示,例如空字串或錯誤訊息。

check_fortran_source_runs("program test
real :: x[*]
call co_sum(x)
end program"
HAVE_COARRAY)

預設情況下,測試原始碼檔案將會被賦予 .F90 副檔名。SRC_EXT 選項可以用來覆寫這個設定,改用 .<extension>

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

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

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