CheckIncludeFileCXX

提供一个宏以检查头文件是否可以包含在 CXX 中。

CHECK_INCLUDE_FILE_CXX

CHECK_INCLUDE_FILE_CXX(<include> <variable> [<flags>])

检查给定的 <include> 文件是否可以包含在 CXX 源文件和存储中，并将结果存储在名为 <variable> 的内部缓存条目中。可选的第三个参数可用于向检查添加编译标志（或在下面使用 CMAKE_REQUIRED_FLAGS）。

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

CMAKE_REQUIRED_FLAGS

传递给编译器的附加标志的字符串。该字符串必须用空格分隔——;-list 将不起作用。在 CMAKE_REQUIRED_FLAGS 的内容之前，会自动将 CMAKE_<LANG>_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 版本中添加。

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

参见模块 CheckIncludeFile 和 CheckIncludeFiles 来检查一个或多个 C 头文件。