C++ 属性: deprecated (C++14 以降)

 

C++

コンパイラサポート

フリースタンディングとホスト

言語

標準ライブラリ

標準ライブラリヘッダー

名前付き要件

機能テストマクロ (C++20)

言語サポートライブラリ

コンセプトライブラリ (C++20)

診断ライブラリ

メモリ管理ライブラリ

メタプログラミングライブラリ (C++11)

汎用ユーティリティライブラリ

コンテナライブラリ

イテレータライブラリ

Rangesライブラリ (C++20)

アルゴリズムライブラリ

文字列ライブラリ

テキスト処理ライブラリ

数値ライブラリ

日付と時刻ライブラリ

入出力ライブラリ

ファイルシステムライブラリ (C++17)

並行サポートライブラリ (C++11)

実行制御ライブラリ (C++26)

Technical specifications (技術仕様)

シンボルインデックス

外部ライブラリ

 

C++言語

全般
プリプロセッサ コメント	キーワード エスケープシーケンス
フロー制御
条件実行文
if	switch
繰り返し文 (ループ)
for 範囲for文 (C++11)	while do-while
ジャンプ文
continue - break	goto - return
関数
関数宣言
ラムダ式
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++の歴史

 

宣言

概要 宣言構文 decl-specifier-seq (宣言指定子シーケンス) Declarator (宣言子) 競合する宣言 指定子 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)     Elaborated type specifier (詳細型指定子) 属性 (C++11)

Declarators (宣言子) 参照 ポインタ 配列 ブロック宣言 単純宣言   →構造化束縛宣言 (C++17) エイリアス宣言 (C++11) 名前空間エイリアス定義 using 宣言 using 指令 static_assert 宣言 (C++11) asm 宣言 不透明 enum 宣言 (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( 文字列リテラル )]]	(2)

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 standard (ISO/IEC 14882:2020)

• 9.12.4 非推奨属性 [dcl.attr.deprecated]

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

• 10.6.4 非推奨属性 [dcl.attr.deprecated]

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

• 7.6.5 非推奨属性 [dcl.attr.deprecated]

関連項目

deprecated のC ドキュメント