CheckCSourceRuns

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

check_c_source_runs
check_c_source_runs(<code> <resultVar>)

检查一次 <code> 中提供的源是否可以构建、链接为一个可执行文件,然后运行。 <code> 必须至少包含一个 main() 函数。

结果存储在由 <resultVar> 指定的内部缓存变量中。构建和运行是否成功,由布尔值 true 表明。构建或运行失败,由布尔值 false 表明,例如空字符串或错误消息。

另请参阅 check_source_runs(),了解更通用的命令语法。

在调用 check_c_source_runs() 之前设置以下任何变量,都会影响编译和链接命令

CMAKE_REQUIRED_FLAGS

传递给编译器的附加标志字符串。字符串必须以空格分隔——;-列表 将不起作用。 CMAKE_<LANG>_FLAGS 的内容和与其关联的特定于配置的变量在 CMAKE_REQUIRED_FLAGS 的内容之前自动添加到编译器命令中。

CMAKE_REQUIRED_DEFINITIONS

形式为 -DFOO-DFOO=bar 的编译器定义的 ;-列表。还将自动添加一个针对 <resultVar> 指定的名称的定义。

CMAKE_REQUIRED_INCLUDES

传递给编译器的头文件搜索路径的 ;-列表。这些将是唯一使用的头文件搜索路径——将忽略 INCLUDE_DIRECTORIES 目录属性的内容。

CMAKE_REQUIRED_LINK_OPTIONS

在 3.14 版本中添加。

要添加到链接命令的选项的 ;-列表(有关更多详情,请参见 try_compile())。

CMAKE_REQUIRED_LIBRARIES

添加 ;-list 到链接命令的库。这些库可以是系统库的名称,也可以是 导入目标(有关详细信息,请参见 try_compile())。

CMAKE_REQUIRED_LINK_DIRECTORIES

添加于版本 3.31。

传递到链接器的库搜索路径的 ;-list(有关详细信息,请参见 try_compile())。

CMAKE_REQUIRED_QUIET

添加于版本 3.1。

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