CheckCompilerFlag

在版本 3.19 中添加。

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

check_compiler_flag

check_compiler_flag(<lang> <flag> <resultVar>)

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

true 仅表示编译器在给出标志时没有发出诊断消息。该标志是否产生任何影响超出了此模块的范围。

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

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

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 中添加。

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