C++ attribute: deprecated (since C++14)

表示使用此属性声明的名称或实体已被 弃用 ，即虽然仍允许使用，但出于某些原因不推荐继续使用。

语法

说明

表示允许使用以此属性声明的名称或实体，但出于某些原因不鼓励使用。编译器通常会对这类使用发出警告。如果指定了 字符串字面量 ，通常会将其包含在警告信息中。

此属性允许在以下名称或实体的声明中使用：

• 类/结构体/联合体 ，例如 struct [ [ deprecated ] ] S ; ,
• 类型定义名 ，包括通过 别名声明 声明的名称，例如：

• [ [ 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 { } ; ，

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

被声明为非弃用的名称可以重新声明为弃用。被声明为弃用的名称无法通过不带此属性的重新声明来取消弃用状态。

示例

#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.

参考文献

参见