将宏标记为已弃用的最佳方法是什么？

Question

我知道如何通过使用将枚举/函数标记为已弃用 __attribute__ ((deprecated))。但是我怎样才能标记常量宏 已弃用？

#define MACRO1 4 //This is deprecated macro

Answer 1

GCC（可能还有其他）

__attribute__((deprecated))

对于只有一个常量表达式的特定示例，您可以使用：

改变

#define X (4)

到

#define X_old (4)

然后添加

const int dep __attribute__((deprecated)) = 0;
#define X ((void)dep, X_old)

加法也有效：

#define X (X_old + dep)

对于过程宏，您可以这样做：

#define P_old do { ... } while(0)
#define P do { (void)dep; P_old; } while(0)

(void) 的唯一功能是抑制警告。谢谢凯文。

#pragma message

另一种解决方案是将所有不推荐使用的宏放在单独的头文件中并使用pragma。您可以将其与#ifdef 等结合使用：

#pragma message ("This header contains deprecated macros")

所有编译器

未引用的标签

使用未引用的标签：

#define P_old do { ... } while(0)
#define P do { P_IS_DEPRECATED: P_old; } while(0)

这不适用于常量表达式宏，并且需要您使用-Wall 进行编译才能获得警告。如果多次使用会触发错误。

未使用的变量：

#define P_old do { ... } while(0)
#define P do { int P_IS_DEPRECATED; P_old; } while(0)

也不适用于常量表达式。还需要-Wall，但可以多次使用。

旁注

请记住将常量表达式宏封装在括号中。宏 #define X 2+3 会生成像 2*X 这样的表达式，以扩展为 2*2+3 而不是 2*(2+3)。