C语言可变参数在宏定义中的应用

       在C语言的标准库中，printf、scanf、sscanf、sprintf、sscanf这些标准库的输入输出函数，参数都是可变的。在调试程序时，我们可能希望定义一个参数可变的输出函数来记录日志，那么用可变参数的宏是一个不错的选择。

在C99中规定宏也可以像函数一样带可变的参数，如：

#define LOG(format, ...) fprintf(stdout, format, __VA_ARGS__)

其中，...表示可变参数列表，__VA_ARGS__在预处理中，会被实际的参数集（实参列表）所替换。
同时gcc还支持带可以变参数名的方式（注意：VC不支持）：

#define LOG(format, args...) fprintf(stdout, format, args)

同样，args在预处理过程中，会被实际的参数集所替换。其用法和上面的方式一样，只是参数的符号有变。

需要注意的是，上述两种方式的可变参数不能省略，尽管可以传一个空参数进去。说到这里，有必要提一下“##”连接符号的用法，“##”的作用是对token进行连接，上例中format，args，__VA_ARGS都可以看作是token，如果token为空，“##”则不进行连接，所以允许省略可变参数。对上述2个示例的改造：

#define LOG(format, ...) fprintf(stdout, format, ##__VA_ARGS__)
#define LOG(format, args...) fprintf(stdout, format, ##args)

即然参数可以省略，那么用宏定义一个开关，实现一个输出日志的函数就简单了：

#ifdef DEBUG
#define LOG(format, ...) fprintf(stdout, ">>>>>" format "<<<<", ##__VA_ARGS__)
#else
#define LOG(format, ...)
#endif

在开发阶段时，在编译选项中加入一个DEBUG宏，即会在程序中使用了LOG宏的地方输出日志，否则只是调用了一个空的LOG宏而已，不会有任何输出。假设源文件为test.c，gcc编译时加上-DDEBUG（-D表示预定宏，在预编译的时候由编译器定义）即在判断DEBUG宏时条件成立，从而达到输出日志的目的：

gcc -o test test.c -DDEBUG

示例：在Android的NDK开发中，打印log的宏：

需要在android.mk文件中加载日志模块，并添加DEBUG选项：

LOCAL_LDLIBS 	:= -llog	#添加日志模块
LOCAL_CFLAGS	+= -DDEBUG

NDKTest.cpp

#include <jni.h>
#include <android/log.h>

#define LOG_TAG "HelloNDK"
#ifdef DEBUG
#define LOGI(...) __android_log_print(ANDROID_LOG_INFO, LOG_TAG, __VA_ARGS__)
#define LOGD(...) __android_log_print(ANDROID_LOG_DEBUG, LOG_TAG, __VA_ARGS__)
#define LOGE(...) __android_log_print(ANDROID_LOG_ERROR, LOG_TAG, __VA_ARGS__)
#else
#define LOGI(...) do{} while(0)
#define LOGD(...) do{} while(0)
#define LOGE(...) do{} while(0)
#endif

JNIEXPORT jint JNICALL JNI_OnLoad(JavaVM* vm, void* reserved)
{
	JNIEnv *env;
	jclass cls;
	if (vm->GetEnv((void**)&env, JNI_VERSION_1_4) != JNI_OK)
	{
		LOGE("init javavm failed!");
		return JNI_ERR;
	}
	cls = env->FindClass("com/learn/ndk/SampleModel");
	if (cls == NULL)
	{
		LOGE("can't find com.learn.ndk.SampleModel.");
		return JNI_ERR;
	}
	class_com_learn_ndk_MainActivity = (jclass)env->NewWeakGlobalRef(cls);
	env->DeleteLocalRef(cls);
	return JNI_VERSION_1_4;
}