C++ attribute: deprecated (since C++14)

Указывает, что имя или сущность, объявленная с этим атрибутом, является устаревшей , то есть использование разрешено, но не рекомендуется по некоторым причинам.

Синтаксис

Объяснение

Указывает, что использование имени или сущности, объявленной с этим атрибутом, разрешено, но не рекомендуется по какой-либо причине. Компиляторы обычно выдают предупреждения при таких использованиях. string-literal , если указан, обычно включается в предупреждения.

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

• класс/структура/объединение , например, struct [ [ deprecated ] ] S ; ,
• typedef-имя , включая объявленные через объявление псевдонима , например,

• [ [ 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 { } ; ,

• специализация шаблона , например, template <> struct [ [ deprecated ] ] X < int > { } ; .

Имя, объявленное без атрибута deprecated, может быть переобъявлено с атрибутом deprecated. Имя, объявленное с атрибутом deprecated, не может быть снято с устаревания путем переобъявления без этого атрибута.

Пример

#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.

Ссылки

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