近日,检查项目中的所有的WARNING,发现了一个有趣的WARNING: “extra tokens at end of #ifndef directive”。从字面上来看是"在#ifndef后面有无效的指令"。私下里写了小程序验证,发现有两种情况可以产生这个WARNING。
程序1:
// directive_1.c
#include <stdio.h>
#ifndef MIN
#define MIN(x, y) ((x) > (y) ? (y) : (x))
#endif /**/x
int main()
{
printf("min val = %d\n", MIN(100, -1));
return 0;
}
以上程序故意在#endif /**/后面加一个无效的字符x,用GCC带-Wall参数编译,如下:
gcc directive_1.c -Wall -o out1
马上产生了告警:
directive_1.c:5:12: warning: extra tokens at end of #endif directive [-Wendif-labels]
#endif /**/x
我立马惊呆了,这样一个明显是"ERROR"的问题,GCC只是一个WARNING,并且生成了可执行二进制文件,执行./out1
,结果正常,效果如下:
min val = -1
程序2:
// directive_2.c
#include <stdio.h>
#ifndef MIN
#define MIN(x, y) ((x) > (y) ? (y) : (x))
#endif
int main()
{
printf("min val = %d\n", MIN(100, -1));
return 0;
}
以上去掉了多余的"x",编译就完全正常了。如下:
wangkai@fiberserver:extra-tokens-at-end-of-#ifndef-directive$ gcc directive_2.c -Wall -o out1
wangkai@fiberserver:extra-tokens-at-end-of-#ifndef-directive$
在进一步的发散了下#ifndef后面可能出现的情况后,发现了还有一种情况可以造成这个告警。
程序3:
// directive_3.c
#include <stdio.h>
#ifndef MIN(x, y)
#define MIN(x, y) ((x) > (y) ? (y) : (x))
#endif
int main()
{
printf("min val = %d\n", MIN(100, -1));
return 0;
}
执行命令"gcc directive_3.c -Wall -o out3
,也神奇的出现了此告警,如下:
wangkai@fiberserver:extra-tokens-at-end-of-#ifndef-directive$ gcc directive_3.c -Wall -o out3
directive_3.c:3:12: warning: extra tokens at end of #ifndef directive
#ifndef MIN(x, y)
^
究其原因,C语言对#ifndef的预处理,只检查关键字,后面的"(x, y)",认为是多余的字符,将括弧去掉写成#ifndef MIN
,就不会告警了。