CheckCXXCompilerFlag

检查一次 CXX 编译器是否支持给定的标志。

check_cxx_compiler_flag

check_cxx_compiler_flag(<flag> <var>)

检查一次 <flag> 是否被编译器接受且无诊断信息。结果存储在 <resultVar> 指定的内部缓存变量中，成功为布尔值 true，失败为布尔值 false。

true 仅表示给定标志时编译器不发出诊断消息。标志是否有效超出本模块的范围。

内部使用 try_compile() 来执行检查。如果 CMAKE_TRY_COMPILE_TARGET_TYPE 设置为 EXECUTABLE（默认值），则检查会编译并链接一个可执行程序。如果设置为 STATIC_LIBRARY，则检查会编译但不链接。

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

在调用 check_cxx_compiler_flag() 之前设置以下任何变量，都可以影响编译和链接命令。这些变量中未知的标志可能会导致误报。

CMAKE_REQUIRED_FLAGS

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

CMAKE_REQUIRED_DEFINITIONS

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

如果此变量评估为布尔 true 值，则将禁止与此检查相关的所有状态消息。