deprecated关键字
最后更新于：2022-04-01 06:39:58
##没有躲过的坑--deprecated关键字
最近两个被一个问题搞的晕晕乎乎，一直把焦点关注在 EXPRESSION SFINAE。
因为对我来说，EXPRESSION SFINAE也是完全新鲜的内容，有时间也发个关于这个特性的博客。
经历了一番周折，下载最新的VS2015，使用低版本的编译器，都未能解决问题。最后关键字deprecated浮出水面，哎，自惭形秽！
**利用 deprecated 声明，您可以将函数重载的特殊形式指定为已弃用，而杂注形式适用于函数名称的所有重载形式。**
**利用 deprecated 声明，您可以指定在编译时显示的消息。 该消息的文本可以来自宏。**
**只能使用 deprecated 杂注将宏标记为已弃用。**
下面的示例演示在使用已弃用的函数时，如何将函数标记为已弃用以及如何指定在编译时将显示的消息。
~~~
// deprecated.cpp
#define MY_TEXT "function is deprecated"
void func1(void) {}
__declspec(deprecated) void func1(int) {}
_
_declspec(deprecated("** this is a deprecated function **")) void func2(int) {}
__declspec(deprecated(MY_TEXT)) void func3(int) {}
int main() {
func1();
func1(1); // error: 'func1': 被声明为已否决
func2(1); // error
func3(1); // error
}
~~~
下面的示例演示在使用已弃用的类时，如何将类标记为已弃用以及如何指定在编译时将显示的消息。
~~~
// deprecate_class.cpp
// compile with: /W3
struct __declspec(deprecated) X {
void f(){}
};
struct __declspec(deprecated("** X2 is deprecated **")) X2 {
void f(){}
};
int main() {
X x; // error
X2 x2; // error
}
~~~
The deprecated __declspec modifier allows you to specify deprecated status for particular forms of overloaded functions.