检查CSourceRuns

检查给定的 C 源代码是否编译并链接到可执行文件,并且随后可以运行。

check_c_source_runs
check_c_source_runs(<code> <resultVar>)

检查 <code> 中提供的源代码是否可以编译为 C 源文件,链接为可执行文件,然后运行。 <code> 必须至少包含一个 main() 函数。如果 <code> 可以成功构建和运行,则由 <resultVar> 指定的内部缓存变量将被设置为 1,否则它将被设置为一个计算结果为布尔值 false 的值(例如空字符串或错误消息)。

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

CMAKE_REQUIRED_FLAGS

要传递给编译器的附加标志。请注意 CMAKE_C_FLAGS 的内容及其关联的特定于配置的变量会自动添加到编译器命令中的 CMAKE_REQUIRED_FLAGS 内容之前。

CMAKE_REQUIRED_DEFINITIONS

A ;-list 形式为``-DFOO`` 或``-DFOO=bar`` 的编译器定义。由 <resultVar> 指定的名称的定义也将自动添加。

CMAKE_REQUIRED_INCLUDES

传递给编译器的标头搜索路径的 ;-list。这些将是 try_run() 使用的唯一标题搜索路径,即:prop_dir:INCLUDE_DIRECTORIES 目录属性的内容将被忽略。

CMAKE_REQUIRED_LINK_OPTIONS

在 3.14 版本加入.

A ;-list 要添加到链接命令的选项(有关更多详细信息,请参阅 try_run())。

CMAKE_REQUIRED_LIBRARIES

A ;-list 要添加到链接命令的库。这些可以是系统库的名称,也可以是 Imported Targets <Imported Targets>`(有关详细信息,请参阅 :command:`try_run)。

CMAKE_REQUIRED_QUIET

在 3.1 版本加入.

如果此变量的计算结果为布尔真值,则将抑制与检查相关的所有状态消息。

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