C attribute: deprecated (since C23)

この属性で宣言された名前またはエンティティが deprecated （非推奨）であることを示します。つまり、使用は許可されていますが、何らかの理由で推奨されていません。

、$タグ内のテキストは翻訳せず保持\; -\; C++固有の用語（Syntax、Explanation、Example、See\; also）は翻訳せず保持\; -\; 元のフォーマットと構造を完全に維持$

構文

説明

この属性で宣言された名前またはエンティティの使用は許可されているが、何らかの理由で推奨されないことを示します。コンパイラは通常、そのような使用に対して警告を発行します。 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.

関連項目