C 属性： deprecated (自 C23 起)
来自 cppreference.cn
表示使用此属性声明的名称或实体已弃用，即允许使用，但由于某种原因不鼓励使用。
目录 |
[编辑] 语法
[[ deprecated ]][[ __deprecated__ ]] |
(1) | ||||||||
[[ deprecated ( string-literal ) ]][[ __deprecated__ ( string-literal ) ]] |
(2) | ||||||||
| string-literal | - | 可用于解释弃用理由和/或建议替换实体的文本 |
[编辑] 解释
表示使用此属性声明的名称或实体被允许使用，但由于某种原因不鼓励使用。编译器通常会对此类使用发出警告。string-literal（如果指定）通常包含在警告中。
此属性允许用于以下名称或实体的声明中
- struct/union: struct [[deprecated]] S;,
- typedef-name: [[deprecated]] typedef S* PS;,
- 对象: [[deprecated]] int x;,
- struct/union 成员: union U { [[deprecated]] int n; };,
- 函数: [[deprecated]] void f(void);,
- 枚举: enum [[deprecated]] E {};,
- 枚举器: enum { A [[deprecated]], B [[deprecated]] = 42 };。
声明为非弃用的名称可以重新声明为弃用。声明为弃用的名称不能通过在没有此属性的情况下重新声明来取消弃用。
[编辑] 示例
运行此代码
#include <stdio.h> [[deprecated]] void TriassicPeriod(void) { puts("Triassic Period: [251.9 - 208.5] million years ago."); } [[deprecated("Use NeogenePeriod() instead.")]] void JurassicPeriod(void) { puts("Jurassic Period: [201.3 - 152.1] million years ago."); } [[deprecated("Use calcSomethingDifferently(int).")]] int calcSomething(int x) { return x * 2; } int main(void) { TriassicPeriod(); JurassicPeriod(); }
可能的输出
Triassic Period: [251.9 - 208.5] million years ago.
Jurassic Period: [201.3 - 152.1] million years ago.
prog.c:23:5: warning: 'TriassicPeriod' is deprecated [-Wdeprecated-declarations]
TriassicPeriod();
^
prog.c:3:3: note: 'TriassicPeriod' has been explicitly marked deprecated here
[[deprecated]]
^
prog.c:24:5: warning: 'JurassicPeriod' is deprecated: Use NeogenePeriod() instead. [-Wdeprecated-declarations]
JurassicPeriod();
^
prog.c:9:3: note: 'JurassicPeriod' has been explicitly marked deprecated here
[[deprecated("Use NeogenePeriod() instead.")]]
^
2 warnings generated.[编辑] 参阅
| C++ 文档 for deprecated
|
