Namespaces
Variants
Views
Actions

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

From cppreference.com
< cpp‎ | language‎ | attributes
 
 
 
 
Attributes
deprecated
(C++14)
(C++17)
(C++20)(C++20)
 

Indicates that the name or entity declared with this attribute is deprecated, that is, the use is allowed, but discouraged for some reason.

[edit] Syntax

[[deprecated]] (1)
[[deprecated( string-literal )]] (2)
string-literal - text that could be used to explain the rationale for deprecation and/or to suggest a replacing entity

[edit] Explanation

Indicates that the use of the name or entity declared with this attribute is allowed, but discouraged for some reason. Compilers typically issue warnings on such uses. The string-literal, if specified, is usually included in the warnings.

This attribute is allowed in declarations of the following names or entities:

A name declared non-deprecated may be redeclared deprecated. A name declared deprecated cannot be un-deprecated by redeclaring it without this attribute.

[edit] Example