C++ attribute: maybe_unused (since C++17)

未使用エンティティに関する警告を抑制します。

構文

説明

この属性は以下のエンティティの宣言に現れることがあります:

• class ： struct [ [ maybe_unused ] ] S ;
• typedef （ エイリアス宣言 によって宣言されたものを含む）： [ [ maybe_unused ] ] typedef S * PS ; 、 using PS [ [ maybe_unused ] ] = S * ;
• 変数（ 静的データメンバ を含む）： [ [ maybe_unused ] ] int x ;
• 非静的データメンバ ： union U { [ [ maybe_unused ] ] int n ; } ; 、
• 関数 ： [ [ maybe_unused ] ] void f ( ) ;
• 列挙型 ： enum [ [ maybe_unused ] ] E { } ;
• 列挙子： enum { A [ [ maybe_unused ] ] , B [ [ maybe_unused ] ] = 42 } ;
• 構造化束縛 ： [ [ maybe_unused ] ] auto [ a, b ] = std:: make_pair ( 42 , 0.23 ) ;

[ [ maybe_unused ] ] で宣言されたエンティティについて、そのエンティティまたはその構造化バインディングが使用されない場合、コンパイラによって発行される未使用エンティティに関する警告は抑制されます。

例

#include <cassert>
[[maybe_unused]] void f([[maybe_unused]] bool thing1,
                        [[maybe_unused]] bool thing2)
{
    [[maybe_unused]] lbl: // ラベル「lbl」は使用されていないため警告なし
    [[maybe_unused]] bool b = not false and not true;
    assert(b); // リリースモードではassertはコンパイルされず、「b」は未使用となる
               // [[maybe_unused]]で宣言されているため警告なし
} // パラメータ「thing1」と「thing2」は使用されていないが警告なし
int main() {}

不具合報告

以下の動作変更欠陥報告書は、以前に公開されたC++標準に対して遡及的に適用されました。

参考文献

関連項目