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

ゞ浴缸里的玫瑰 2022-08-14 00:59 257阅读 0赞

在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;
    }