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

Подавляет предупреждения о неиспользуемых сущностях.

Синтаксис

Объяснение

Этот атрибут может появляться в объявлении следующих сущностей:

• класс : 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); // в режиме release, assert компилируется, и "b" не используется
               // предупреждения нет, так как объявлено [[maybe_unused]]
} // параметры "thing1" и "thing2" не используются, предупреждения нет
int main() {}

Отчеты о дефектах

Следующие отчеты об изменениях в поведении, являющиеся дефектными, были применены ретроактивно к ранее опубликованным стандартам C++.

Ссылки

Смотрите также