C++ 屬性： deprecated (自 C++14 起)

 

C++

編譯器支援

自由（freestanding）與宿主（hosted）

語言

標準庫

標準庫標頭檔案

具名要求

特性測試宏 (C++20)

語言支援庫

概念庫 (C++20)

診斷庫

記憶體管理庫

超程式設計庫 (C++11)

通用工具庫

容器庫

迭代器庫

範圍庫 (C++20)

演算法庫

字串庫

文字處理庫

數值庫

日期和時間庫

輸入/輸出庫

檔案系統庫 (C++17)

併發支援庫 (C++11)

執行控制庫 (C++26)

技術規範

符號索引

外部庫

 

C++ 語言

通用主題
預處理器 註釋	關鍵詞 轉義序列
流程控制
條件執行語句
if	switch
迭代語句（迴圈）
for range-for (C++11)	while do-while
跳轉語句
continue - break	goto - return
函式
函式宣告
Lambda 函式表示式
inline 說明符
動態異常規範 (直到 C++17*)
noexcept 說明符 (C++11)
異常
throw 表示式 try 塊	catch 處理程式
名稱空間
名稱空間宣告	命名空間別名
型別
基本型別 列舉型別 函式型別	類/結構體型別 聯合型別
說明符
const/volatile decltype (C++11) auto (C++11)	constexpr (C++11) consteval (C++20) constinit (C++20)
儲存期說明符
初始化
預設初始化 值初始化 零初始化 複製初始化 直接初始化	聚合初始化 列表初始化 (C++11)   常量初始化 引用初始化

表示式
值類別 求值順序	運算子 運算子優先順序
替代表示
字面量
布林 - 整型 - 浮點型
字元 - 字串 - nullptr (C++11)
使用者定義 (C++11)
工具
屬性 (C++11)
型別
typedef 宣告
類型別名宣告 (C++11)
型別轉換
隱式轉換 static_cast const_cast	顯式轉換 dynamic_cast reinterpret_cast
記憶體分配
new 表示式	delete 表示式
類
類宣告 建構函式 this 指標	訪問說明符 friend 說明符
類特有的函式屬性
虛擬函式 override 說明符 (C++11)   final 說明符 (C++11)	explicit (C++11) static
特殊成員函式
預設建構函式 複製建構函式 移動建構函式 (C++11)	複製賦值 移動賦值 (C++11) 解構函式
模板
類模板 函式模板	模板特化 引數包 (C++11)
雜項
內聯彙編	C++ 歷史

 

宣告

概覽 宣告語法 宣告說明符序列 宣告符 衝突宣告 說明符 typedef inline virtual 函式說明符 explicit 函式說明符 friend constexpr (C++11) consteval (C++20) constinit (C++20) 儲存類說明符 翻譯單元區域性 (C++20) class/struct union enum decltype (C++11) auto (C++11) alignas (C++11) constvolatile 包索引說明符 (C++26)     細化型別說明符 屬性 (C++11)

宣告符 引用 指標 陣列 塊宣告 簡單宣告   →結構化繫結宣告 (C++17) 別名宣告 (C++11) 命名空間別名定義 using 宣告 using 指令 static_assert 宣告 (C++11) asm 宣告 不透明列舉宣告 (C++11) 其他宣告 名稱空間定義 函式宣告 類模板宣告 函式模板宣告 顯式模板例項化 (C++11) 顯式模板特化 連結規範 屬性宣告 (C++11) 空宣告

 

屬性

assume (C++23)

carries_dependency (C++11)(直至 C++26)

deprecated (C++14)

fallthrough (C++17)

indeterminate (C++26)

likely (C++20)

maybe_unused (C++17)

nodiscard (C++17)

noreturn (C++11)

no_unique_address (C++20)

optimize_for_synchronized (TM TS)

unlikely (C++20)

 

指示用此屬性宣告的名稱或實體已棄用，即允許使用，但由於某些原因不建議使用。

語法

[[deprecated]]	(1)
[[deprecated( string-literal )]]	(2)

string-literal

-

一個未求值的字串字面量，可用於解釋棄用的原因和/或建議替換實體

說明

指示使用此屬性宣告的名稱或實體是被允許的，但由於某些原因不鼓勵使用。編譯器通常對此類使用發出警告。如果指定了 string-literal，它通常會包含在警告中。

此屬性允許用於以下名稱或實體的宣告中：

• 類/結構/聯合，例如 struct [[deprecated]] S;，
• typedef-name，包括由別名宣告宣告的，例如，

• [[deprecated]] typedef S* PS;,
• using PS [[deprecated]] = S*;,

• (非成員)變數，例如 [[deprecated]] int x;，
• 靜態資料成員，例如 struct S { [[deprecated]] static constexpr char CR{13}; };，
• 非靜態資料成員，例如 union U { [[deprecated]] int n; };，
• 函式，例如 [[deprecated]] void f();，
• 名稱空間，例如 namespace [[deprecated]] NS { int x; }，
• 列舉，例如 enum [[deprecated]] E {};，

列舉器，例如 enum { A [[deprecated]], B [[deprecated]] = 42 };，

(C++17 起)

• 模板特化，例如 template<> struct [[deprecated]] X<int> {};。

一個未宣告為棄用的名稱可以被重新宣告為棄用。一個已宣告為棄用的名稱不能透過在沒有此屬性的情況下重新宣告來取消棄用。

示例

執行此程式碼

#include <iostream>
 
[[deprecated]]
void TriassicPeriod()
{
    std::clog << "Triassic Period: [251.9 - 208.5] million years ago.\n";
}
 
[[deprecated("Use NeogenePeriod() instead.")]]
void JurassicPeriod()
{
    std::clog << "Jurassic Period: [201.3 - 152.1] million years ago.\n";
}
 
[[deprecated("Use calcSomethingDifferently(int).")]]
int calcSomething(int x)
{
    return x * 2;
}
 
int main()
{
    TriassicPeriod();
    JurassicPeriod();
}

可能的輸出

Triassic Period: [251.9 - 208.5] million years ago.
Jurassic Period: [201.3 - 152.1] million years ago.
 
main.cpp:20:5: warning: 'TriassicPeriod' is deprecated [-Wdeprecated-declarations]
    TriassicPeriod();
    ^
main.cpp:3:3: note: 'TriassicPeriod' has been explicitly marked deprecated here
[[deprecated]]
  ^
main.cpp:21:5: warning: 'JurassicPeriod' is deprecated: Use NeogenePeriod() instead ⮠
 [-Wdeprecated-declarations]
    JurassicPeriod();
    ^
main.cpp:8:3: note: 'JurassicPeriod' has been explicitly marked deprecated here
[[deprecated("Use NeogenePeriod() instead")]]
  ^
2 warnings generated.

參考

• C++23 標準 (ISO/IEC 14882:2024)

• 9.12.5 棄用屬性 [dcl.attr.deprecated]

• C++20 標準 (ISO/IEC 14882:2020)

• 9.12.4 棄用屬性 [dcl.attr.deprecated]

• C++17 標準 (ISO/IEC 14882:2017)

• 10.6.4 棄用屬性 [dcl.attr.deprecated]

• C++14 標準 (ISO/IEC 14882:2014)

• 7.6.5 棄用屬性 [dcl.attr.deprecated]

參閱

C 文件 for deprecated