C 属性： 已弃用 (自 C23 起)
来自 cppreference.com
指示使用此属性声明的名称或实体已 弃用，即允许使用，但出于某种原因不建议使用。
内容 |
[编辑] 语法
[[ deprecated ]][[ __deprecated__ ]] |
(1) | ||||||||
[[ deprecated ( 字符串字面量 ) ]][[ __deprecated__ ( 字符串字面量 ) ]] |
(2) | ||||||||
| 字符串字面量 | - | 可以用来解释弃用理由和/或建议替换实体的文本 |
[编辑] 说明
指示使用此属性声明的名称或实体的使用是允许的，但出于某种原因不建议使用。编译器通常会对这种使用发出警告。字符串字面量（如果指定）通常包含在警告中。
此属性允许在以下名称或实体的声明中使用
- 结构体/联合体: struct [[deprecated]] S;,
- typedef 名字: [[deprecated]] typedef S* PS;,
- 对象：[[deprecated]] int x;,
- 结构体/联合体成员：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++ 文档 对于 已弃用
|
