检查 FortranSourceCompiles¶

在 3.1 版本加入.

检查给定的 Fortran 源代码是否编译并链接到可执行文件中。

check_fortran_source_compiles¶

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

检查 <code> 中提供的源代码是否可以编译为 Fortran 源文件并链接为可执行文件。 <code> 必须是 Fortran program。

check_fortran_source_compiles("program test
error stop
end program"
HAVE_ERROR_STOP
SRC_EXT .F90)

当编译器缺乏对必要功能的支持，或者特定供应商库与正在使用的 Fortran 编译器版本不兼容时，此命令可以帮助避免昂贵的构建过程。此生成时检查可能会在主构建过程之前向用户提供此类建议。另请参阅 check_fortran_source_runs() 命令以运行编译后的代码。

结果将存储在内部缓存变量“<resultVar>”中，布尔值为真表示成功，布尔值为假表示失败。

如果提供了“FAIL_REGEX”，则通过检查输出中的任何内容是否与任何指定的正则表达式匹配来确定失败。

默认情况下，测试源文件将被赋予一个 .F 文件扩展名。 SRC_EXT 选项可用于用 .<extension> 覆盖它——.F90 是一个典型的选择。

底层检查由 try_compile() 命令执行。在调用 check_fortran_source_compiles() 之前设置以下任何变量可以影响编译和链接命令：

CMAKE_REQUIRED_FLAGS: 要传递给编译器的附加标志。请注意 CMAKE_Fortran_FLAGS 的内容及其关联的特定于配置的变量会自动添加到编译器命令中的 CMAKE_REQUIRED_FLAGS 内容之前。
CMAKE_REQUIRED_DEFINITIONS: A ;-list 形式为``-DFOO`` 或``-DFOO=bar`` 的编译器定义。由 <resultVar> 指定的名称的定义也将自动添加。
CMAKE_REQUIRED_INCLUDES: 传递给编译器的标头搜索路径的 ;-list。这些将是 try_compile() 使用的唯一标题搜索路径，即 INCLUDE_DIRECTORIES 目录属性的内容将被忽略。
CMAKE_REQUIRED_LINK_OPTIONS: 在 3.14 版本加入.

A ;-list 要添加到链接命令的选项（有关更多详细信息，请参阅 try_compile()）。
CMAKE_REQUIRED_LIBRARIES: A ;-list 要添加到链接命令的库。这些可以是系统库的名称，也可以是 Imported Targets <Imported Targets>`（有关详细信息，请参阅 :command:`try_compile）。
CMAKE_REQUIRED_QUIET: 如果此变量的计算结果为布尔真值，则将抑制与检查相关的所有状态消息。

检查只执行一次，结果缓存在名为 <resultVar> 的变量中。每次后续 CMake 运行都将重新使用此缓存值，而不是再次执行检查，即使 <code> 更改也是如此。为了强制重新评估检查，必须从缓存中手动删除由 <resultVar> 命名的变量。