C 属性： deprecated (C23 起)

 

C

语言

头文件

类型支持

程序工具

变参数函数支持

动态内存管理

错误处理

日期和时间工具

字符串库

算法

数值

输入/输出支持

本地化支持

线程支持 (C11)

原子操作 (C11)

技术规范

 

C 语言

基本概念

关键词

预处理器

语句

表达式

初始化

声明

函数

杂项

C 的历史

技术规范

 

声明

指针

数组

enum

struct

union

位域

原子类型 (C11)

const

volatile

restrict (C99)

_Alignas (C11)

存储期与链接

外部及试探性定义

typedef

_Static_assert (C11)

属性 (C23)

 

属性

deprecated (C23)

fallthrough (C23)

nodiscard (C23)

maybe_unused (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.