C 属性： deprecated (C23 起)

 

C

编译器支持

语言

头文件

类型支持

程序工具

变参数函数支持

错误处理

动态内存管理

字符串库

算法

数值

日期和时间工具

输入/输出支持

本地化支持

并发支持 (C11)

技术规范

符号索引

 

C 语言

基本概念

关键词

预处理器

语句

表达式

初始化

声明

函数

杂项

C 的历史

技术规范

 

声明

指针

数组

enum

struct

union

位域

原子类型 (C11)

const

volatile

restrict (C99)

对齐说明符 (C11)

存储期与链接

外部及试探性定义

typedef

静态断言 (C11)

属性 (C23)

 

属性

deprecated (C23)

fallthrough (C23)

nodiscard (C23)

maybe_unused (C23)

noreturn_Noreturn (C23)(C23)(弃用)

unsequenced (C23)

reproducible (C23)

 

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

语法

[[ 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 的名字不能通过不带此属性地重声明而变为未弃用。

示例

运行此代码

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