CheckLinkerFlag

版本 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 等变量转发标志，因此这些变量中未知的标志可能会导致此检查出现误报。