CheckCSourceCompiles

一次检查是否能构建 C 源代码。

check_c_source_compiles

check_c_source_compiles(<code> <resultVar>
                        [FAIL_REGEX <regex1> [<regex2>...]])

一次检查在 <code> 中提供的源是否能被构建。结果存储在由 <resultVar> 指定的内部缓存变量中，成功时为布尔 true，失败时为布尔 false。

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

在内部，try_compile() 用于编译源代码。如果 CMAKE_TRY_COMPILE_TARGET_TYPE 设置为 EXECUTABLE（默认），则源代码将被编译并链接为可执行程序。如果设置为 STATIC_LIBRARY，源代码将被编译，但不会被链接。在任何情况下，所有函数都必须照常声明。

另请参阅 check_source_compiles() 以获取更通用的命令语法。

另请参阅 check_source_runs() 以运行已编译的源代码。

在调用 check_c_source_compiles() 之前，可以通过设置以下任何变量来影响编译和链接命令

CMAKE_REQUIRED_FLAGS

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

CMAKE_REQUIRED_DEFINITIONS

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

CMAKE_REQUIRED_INCLUDES

;-列表 中经过编译器传递的头部搜索路径。只有这些头部搜索路径将被使用，不会考虑 INCLUDE_DIRECTORIES 目录属性的内容。

CMAKE_REQUIRED_LINK_OPTIONS

3.14 版本中添加。

;-列表 中将添加到链接命令的选项（更多详细信息，请参阅 try_compile()）。

CMAKE_REQUIRED_LIBRARIES

;-列表 中将添加到链接命令的库。这些库可以是系统库的名称，也可以是 导入目标（更多详细信息，请参阅 try_compile()）。

CMAKE_REQUIRED_LINK_DIRECTORIES

3.31 版本中添加。

;-列表 中将传递给链接器的库搜索路径（更多详细信息，请参阅 try_compile()）。

CMAKE_REQUIRED_QUIET

3.1 版本中添加。

如果此变量计算得出的布尔值为真，则将禁止显示与检查相关的状态消息。