C 属性： 已弃用 (自 C23 起)
来自 cppreference.cn
< c | language | attributes
指示使用此属性声明的名称或实体已被弃用，即允许使用，但不建议出于某种原因使用。
目录 |
[编辑] 语法
[[ 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 };.
声明为非 deprecated 的名称可以重新声明为 deprecated。声明为 deprecated 的名称不能通过重新声明而不使用此属性来取消 deprecated 状态。
[编辑] 示例
运行此代码
#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++ 文档 关于 deprecated
|
