CheckFunctionExists¶

检查一次是否可以从系统库链接 C 函数。

check_function_exists¶

check_function_exists(<function> <variable>)

检查系统库是否提供了 <function>，并将结果存储在内部缓存变量 <variable> 中。

以下变量可以在调用此宏之前设置，以修改检查的运行方式

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

CMAKE_REQUIRED_DEFINITIONS
形式为 -DFOO 或 -DFOO=bar 的编译器定义 ;-list。<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 版本中添加。

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

注意

由于以下原因，建议使用 CheckSymbolExists 或 CheckSourceCompiles 模块，而不是此模块