C++ 属性： deprecated (C++14 起)

指示声明有此属性的名字或实体被弃用，即允许但因故不鼓励使用。

语法


`[[deprecated]]`	(1)

`[[deprecated(` 字符串字面量 `)]]`	(2)

字符串字面量

-

能用于解释弃用的理由并/或提议代替用实体的不求值字符串字面量

解释

指示允许使用声明有此属性的名称或实体，但因故不鼓励使用。编译器通常会对其使用情况发出警告。若指定了字符串字面量，则它通常被包含于警告中。

下列名字或实体的声明中允许使用这个属性：

class/struct/union，例如 struct [[deprecated]] S;，
typedef 名，也包括别名声明，例如

[[deprecated]] typedef S* PS;
using PS [[deprecated]] = S*;，

（非成员）变量，例如 [[deprecated]] int x;，
静态数据成员，例如 struct S { [[deprecated]] static constexpr char CR{13}; };，
非静态数据成员，例如 union U { [[deprecated]] int n; };，
函数，例如 [[deprecated]] void f();，
命名空间，例如 namespace [[deprecated]] NS { int x; }，
枚举，例如 enum [[deprecated]] E {};，

枚举项，例如 enum { A [[deprecated]], B [[deprecated]] = 42 }; (C++17 起)，

(C++17 起)

模板特化，例如 template<> struct [[deprecated]] X<int> {};。

声明时未弃用的名字可被重声明为 deprecated。声明为 deprecated 的名字不能通过重声明它而不带此属性变为未弃用。

示例

运行此代码

#include <iostream>
 
[[deprecated]]
void TriassicPeriod()
{
    std::clog << "Triassic Period: [251.9 - 208.5] million years ago.\n";
}
 
[[deprecated("Use NeogenePeriod() instead.")]]
void JurassicPeriod()
{
    std::clog << "Jurassic Period: [201.3 - 152.1] million years ago.\n";
}
 
[[deprecated("Use calcSomethingDifferently(int).")]]
int calcSomething(int x)
{
    return x * 2;
}
 
int main()
{
    TriassicPeriod();
    JurassicPeriod();
}

可能的输出：

Triassic Period: [251.9 - 208.5] million years ago.
Jurassic Period: [201.3 - 152.1] million years ago.
 
main.cpp:20:5: warning: 'TriassicPeriod' is deprecated [-Wdeprecated-declarations]
    TriassicPeriod();
    ^
main.cpp:3:3: note: 'TriassicPeriod' has been explicitly marked deprecated here
[[deprecated]]
  ^
main.cpp:21:5: warning: 'JurassicPeriod' is deprecated: Use NeogenePeriod() instead ⮠
 [-Wdeprecated-declarations]
    JurassicPeriod();
    ^
main.cpp:8:3: note: 'JurassicPeriod' has been explicitly marked deprecated here
[[deprecated("Use NeogenePeriod() instead")]]
  ^
2 warnings generated.

引用

C++23 标准（ISO/IEC 14882:2024）：

9.12.5 Deprecated attribute [dcl.attr.deprecated]

C++20 标准（ISO/IEC 14882:2020）：

9.12.4 Deprecated attribute [dcl.attr.deprecated]

C++17 标准（ISO/IEC 14882:2017）：

10.6.4 Deprecated attribute [dcl.attr.deprecated]

C++14 标准（ISO/IEC 14882:2014）：

7.6.5 Deprecated attribute [dcl.attr.deprecated]

编译器支持
自立实现与有宿主实现
语言
标准库
标准库标头
具名要求
功能特性测试宏 (C++20)
语言支持库
概念库 (C++20)
元编程库 (C++11)
诊断库
通用工具库
字符串库
容器库
迭代器库
范围库 (C++20)
算法库
数值库
本地化库
输入/输出库
文件系统库 (C++17)
正则表达式库 (C++11)
并发支持库 (C++11)
技术规范
符号索引
外部库

assume (C++23)
carries_dependency (C++11)
deprecated (C++14)
fallthrough (C++17)
indeterminate (C++26)
likely (C++20)
maybe_unused (C++17)
nodiscard (C++17)
noreturn (C++11)
no_unique_address (C++20)
optimize_for_synchronized (TM TS)
unlikely (C++20)

C++ 属性： deprecated (C++14 起)

语法

解释

示例

引用

参阅

导航