如何在 GCC 中弃用 C 预处理器宏？

Question

我知道如何使用__attribute__((deprecated))或[[deprecated]]来弃用这样的函数：

int old_fn() __attribute__ ((deprecated));
[[deprecated]] int old_fn2();

但是如何弃用这样的宏：

#define OLD_MACRO 1

Answer 1

不错，优雅的解决方案，但是取决于启用的 C99（适用于 gcc 4.8.2 或更高版本，未在早期版本上测试）：

#define DEPRECATED_MACRO1 _Pragma ("GCC warning \"'DEPRECATED_MACRO1' macro is deprecated\"") 7
#define DEPRECATED_MACRO2(...) _Pragma ("GCC warning \"'DEPRECATED_MACRO2' macro is deprecated\"") printf(__VA_ARGS__)

int main(int argc, char*argv[])
{
    int n = DEPRECATED_MACRO1;
    DEPRECATED_MACRO2("%d\n", n);
    return 0;
}

Answer 2

我认为你能做的最好的事情是这样的：

#ifdef USE_DEPRECATED_MACROS
#warning using deprecated macros
#define OLD_MACRO 1
...
#endif

通过这种方式，您可以强制用户将 -DUSE_DEPRECATED_MACROS 添加到他们的编译器选项中，并且他们会收到警告。

Answer 3

您可以确保这些宏会扩展为包含会触发__attribute__((deprecated))警告的表达式的内容。

对于类似函数的宏，这很容易（尤其是使用逗号运算符），但对于常量定义或非标准宏，这可能更复杂，因为这些扩展的上下文不同。 我认为你可以这样做：

#define DEPRECATE(name) static inline void __attribute__((deprecated)) deprecate_ ## name (void) { ; }
...
#define MAX(x, y) (DEPRECATE(MAX), x>y?x:y)
// yeah, yeah, it repeats args in the body, but it's just an example

对于常量定义，您可能想假设主体必须在无需生成代码的情况下进行评估，例如在函数体外部、在 switch/case 的目标中，或作为函数内静态变量的初始值.

这很棘手，但您可以在很多事情上做到这一点。

我希望 C 有一个__builtin_warn(const char *)可以在编译器级别（非预处理器）工作并使这样的事情更容易。

对于常量定义，您可以执行以下操作：

#define THREE (DEPRICATED(THREE),3)

Answer 4

由于宏不是编译器的一部分（它们是预处理器功能），因此没有干净的方法来做到这一点。 充其量，将已弃用的宏放在一个填充了#warnings 的新头文件中。 这当然会破坏现有代码，但这是保证引起人们注意弃用的一种方法。