没有躲过的坑--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.