c - 这个 C 代码是什么意思 (G_GNUC_PRINTF)？

Question

static void ddict_debug(const char* fmt, ...) G_GNUC_PRINTF(1, 2);

我在 .c 文件中找到了这个，但我不明白这一行:是否只有一个或两个函数声明？

这段代码是什么意思？

Answer 1

G_GNUC_PRINTF() 是一个 glib 库预处理器宏。对于 gcc 编译器，它定义如下(来自 glib-2.4.5/glib/gmacros.h):

#define G_GNUC_PRINTF( format_idx, arg_idx )    \
  __attribute__((__format__ (__printf__, format_idx, arg_idx)))

来自gnome documentation :

Expands to the GNU C format function attribute if the compiler is gcc. This is used for declaring functions which take a variable number of arguments, with the same syntax as printf(). It allows the compiler to type-check the arguments passed to the function.

Place the attribute after the function declaration, just before the semicolon.

Parameters:

format_idx: the index of the argument corresponding to the format string (The arguments are numbered from 1)

arg_idx: the index of the first of the format arguments

示例 1:

static void ddict_debug(const char* fmt, ...) G_GNUC_PRINTF(1, 2);
//                                   |    |                 |  |
// format string, format_idx = 1 ----+    |            <----+  | 
// format arguments, arg_idx = 2 ---------+            <-------+

示例 2:

static void foo_debug(int foo, const char* fmt, ...) G_GNUC_PRINTF(2, 3);
//                         |                |    |                 |  |
// not a printf argument --+                |    |                 |  |
// format string, format_idx = 2 -----------+    |            <----+  |
// format arguments, arg_idx = 3 ----------------+            <-------+

总结:

Is there just one function declaration or two ?

定义了一个类似 printf() 的函数。宏告诉编译器对传递给函数的参数进行类型检查。