C 屬性： deprecated (自 C23 起)

 

C

編譯器支援

語言

標頭檔案

型別支援

程式工具

變參函式支援

錯誤處理

動態記憶體管理

字串庫

演算法

數值

日期和時間工具

輸入/輸出支援

本地化支援

併發支援 (C11)

技術規範

符號索引

 

C 語言

基本概念

關鍵詞

預處理器

語句

表示式

初始化

宣告

函式

雜項

C 的歷史

技術規範

 

宣告

指標

陣列

enum

struct

union

位域

原子型別 (C11)

const

constexpr (C23)

volatile

restrict (C99)

對齊說明符

儲存期和連結

外部和暫定定義

typedef

靜態斷言

屬性 (C23)

 

屬性

deprecated (C23)

fallthrough (C23)

nodiscard (C23)

maybe_unused (C23)

noreturn_Noreturn (C23)(C23)(deprecated)

unsequenced (C23)

reproducible (C23)

 

表示使用此屬性宣告的名稱或實體已棄用，即允許使用，但由於某種原因不鼓勵使用。

語法

[[ 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