LINK_WARNING_AS_ERROR

4.0 版本新增。

指定是否将链接器警告视为错误。如果启用，则会添加一个将链接器警告视为错误的标志。如果在 cmake(1) 命令行中给出了 cmake --link-no-warning-as-error 选项，则此属性将被忽略。

此属性接受一个 分号分隔列表，其中包含以下值：

• LINKER: 将链接器警告视为错误。

• DRIVER: 在驱动链接步骤时将编译器警告视为错误。有关更多信息，请参阅 COMPILE_WARNING_AS_ERROR 目标属性。

此外，为了与 COMPILE_WARNING_AS_ERROR 目标属性保持一致，还可以指定一个布尔值：

• True 值：这等同于 LINKER 和 DRIVER 值。

• False 值：为目标禁用此功能。

此属性并非对所有链接器都实现了。如果使用的链接器没有相应的实现，它将被静默忽略。当前实现的 编译器链接器ID 如下：

• AIX

• AppleClang

• GNU

• GNUgold

• LLD

• MOLD

• MSVC

• Solaris

此属性由变量 CMAKE_LINK_WARNING_AS_ERROR 的值初始化，前提是该变量在目标创建时已被设置。