如何将 Qt 中的某些内容标记为过时（已弃用）？

Question

Qt 4.7 中的 C++ 中是否存在 Q_OBSOLETE 或 Q_DEPRECATED？

或者有类似的C++宏或关键字吗？

Answer 1

尽管不是 C++ 标准，但只要使用该

#warning 

指令

就不太可能遇到不支持它的编译器 (请参阅这个问题）。

Answer 2

2023：

是的，Qt 为此定义了 QT_DEPRECATED 和 QT_DEPRECATED_X 宏：

QT_DEPRECATED void myOldFunc();
QT_DEPRECATED_X("use myNewFunc instead") void myOldFunc2();

区别只是文本消息。
此外，C++14 将 [[deprecated("text")]] 属性作为标准提供。如果您使用 C++ 14+，则似乎会在幕后使用此属性。

Answer 3

您可能想要自己做一些类似的事情：

#ifdef Q_TREAT_OBSOLETE_AS_ERRORS
#define Q_OBSOLETE(X) \
        BOOST_STATIC_ASSERT(false); \
        X

#else 
#define Q_OBSOLETE(X) X
#endif

如果没有定义 Q_TREAT_OBSOLETE_AS_ERRORS ，此构造只是替换一些已弃用的代码/部分代码，否则会生成编译时错误。

请注意，BOOST_STATIC_ASSERT 没有范围限制，Q_OBSOLETE 宏也是如此。

这可能不是解决您的问题的最佳方法，实际上我不确定这是否有用。

您可以将代码标记为 @obsolete 或简单地在注释中指出。

Answer 4

通过“不推荐使用的构造”，您真正的意思是“不推荐使用的成员函数”。您要求编译时警告以引起您对任何已弃用函数的调用站点的注意。

在标准 C++ 中这是不可能以任何合理的方式实现的，而且我在 G++ 中也没有看到任何支持这一点的属性。如果编译器还没有对 Qt 的支持，那么 Qt 就无法真正添加这样的功能。

但是，Microsoft Visual C++ 支持 __declspec(已弃用) 扩展，我想可以为 G++ 4.5 编写一个添加类似功能的编译器插件。

Answer 5

如果您使用 Q_DECL_DEPRECATED 您应该得到您正在寻找的结果，例如：

Q_DECL_DEPRECATED void foo();

Answer 6

1. 将真正的功能从公共范围中拉出来。
2. 在公共范围内创建另一个同名的函数。
3. 在该函数中插入警告/失败代码。
4. 用新来称呼原来的。