检查包含文件

提供一个宏来检查一个或多个头文件的列表是否可以包含在一起。

CHECK_INCLUDE_FILES
CHECK_INCLUDE_FILES("<includes>" <variable> [LANGUAGE <language>])

检查给定的 <includes> 列表是否可以一起包含在源文件中,并将结果存储在名为 <variable> 的内部缓存条目中。将 <includes> 参数指定为头文件名的 ;-list

如果设置了 LANGUAGE ,则将使用指定的编译器来执行检查。可接受的值为“C”和“CXX”。如果未设置,则在启用时将使用 C 编译器。如果未启用 C 编译器,则在启用时将使用 C++ 编译器。

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

CMAKE_REQUIRED_FLAGS

编译命令行标志的字符串。

CMAKE_REQUIRED_DEFINITIONS

a ;-list 要定义的宏 (-DFOO=bar)。

CMAKE_REQUIRED_INCLUDES

a ;-list 要传递给编译器的标头搜索路径。

CMAKE_REQUIRED_LINK_OPTIONS

在 3.14 版本加入: a ;-list 添加到链接命令的选项。

CMAKE_REQUIRED_LIBRARIES

a ;-list 要添加到链接命令的库。请参阅政策:policy:CMP0075

CMAKE_REQUIRED_QUIET

在 3.1 版本加入: 在没有消息的情况下安静地执行。

请参阅模块:module:CheckIncludeFile 和:module:CheckIncludeFileCXX 以检查 CCXX 语言中的单个头文件。