检查链接器标志

在 3.18 版本加入.

检查编译器是否支持给定的链接标志。

check_linker_flag

check_linker_flag(<lang> <flag> <var>)

检查链接 <flag> 是否被 <lang> 编译器接受而无需诊断。将结果存储在名为“<var>”的内部缓存条目中。

此命令临时设置 CMAKE_REQUIRED_LINK_OPTIONS 变量并从 CheckSourceCompiles 模块调用 check_source_compiles() 命令。请参阅该模块的文档以获取可以以其他方式修改构建的变量列表。

底层实现依赖于 LINK_OPTIONS 属性来检查指定的标志。也可以使用 LINKER: 前缀，如 target_link_options() 命令中所述。

此检查的肯定结果仅表示编译器在给定链接标志时未发出诊断消息。该标志是否有任何影响，甚至是否有特定影响超出了本模块的范围。

备注

由于 try_compile() 命令转发来自 CMAKE_<LANG>_FLAGS 等变量的标志，此类变量中的未知标志可能会导致此检查出现假阴性。