我的错误报告库中有一个函数,其标题中的声明如下:
extern void err_logmsg(FILE *fp, int flags, int estat, const char *format, ...)
PRINTFLIKE(4,5);
PRINTFLIKE 是大写的,因此当我不使用 GCC 时,我可以将其定义为空。这种用法表示前三个参数没有什么特别的,但第四个参数是一个格式字符串,就像 printf() 使用的那样(实际上,在内部,它被传递给 vfprintf()),以及与之对应的参数(格式化使用格式字符串)从第五个参数开始。
这意味着如果我输入:
err_logmsg(stdout, ERR_ABORT, 1, "%s: %d\n", errno, strerror(errno));
我会得到一个编译错误,因为errno 是一个int 并且strerror(errno) 返回一个指向字符串的指针。我可以通过更改格式字符串或第五个和第六个参数来修复错误。 (ERR_ABORT 是在声明 err_logmsg() 的同一标头中定义的一组标志。)
PRINTFLIKE 宏中有两个数字,因为格式字符串和格式字符串使用的第一个参数之间可能还有其他参数。例如,一个替代函数可以是:
extern void err_writer(FILE *fp, const char *format, int flags, int estat, ...)
PRINTFLIKE(2,5);
这告诉编译器格式化字符串是第二个参数,但是被格式化的相应参数仍然从第五个参数开始出现。
此代码的头文件包含以下行:
#ifdef __GNUC__
#define PRINTFLIKE(n,m) __attribute__((format(printf,n,m)))
#define NORETURN() __attribute__((noreturn))
#else
#define PRINTFLIKE(n,m) /* If only */
#define NORETURN() /* If only */
#endif /* __GNUC__ */