关于可变的参数列表va_list的笔记

案例代码：

int CDECL MessageBoxPrintf (TCHAR * szCaption, TCHAR * szFormat, ……)
{
TCHAR   szBuffer [1024] ;
va_list pArgList ;

// The va_start macro (defined in STDARG.H) is usually equivalent to:
// pArgList = (char *) &szFormat + sizeof (szFormat) ;

va_start (pArgList, szFormat) ;

// The last argument to wvsprintf points to the arguments

_vsntprintf (szBuffer, sizeof (szBuffer) / sizeof (TCHAR),
szFormat, pArgList) ;

// The va_end macro just zeroes out pArgList for no good reason

va_end (pArgList) ;

return MessageBox (NULL, szBuffer, szCaption, 0) ;
}

va_list arg_ptr：定义一个指向个数可变的参数列表指针；

va_start(arg_ptr, argN)：使参数列表指针arg_ptr指向函数参数列表中的第一个可选参数，说明：argN是位于第一个可选参数之前的固定参数，（或者说，最后一个固定参数；…之前的一个参数），函数参数列表中参数在内存中的顺序与函数声明时的顺序是一致的。如果有一va函数的声明是void
va_test(char a, char b, char c, …)，则它的固定参数依次是a,b,c，最后一个固定参数argN为c，因此就是va_start(arg_ptr, c)。

va_arg(arg_ptr, type)：返回参数列表中指针arg_ptr所指的参数，返回类型为type，并使指针arg_ptr指向参数列表中下一个参数。

va_copy(dest, src)：dest，src的类型都是va_list，va_copy()用于复制参数列表指针，将dest初始化为src。

va_end(arg_ptr)：清空参数列表，并置参数指针arg_ptr无效。说明：指针arg_ptr被置无效后，可以通过调用va_start()、va_copy()恢复arg_ptr。每次调用va_start() / va_copy()后，必须得有相应的va_end()与之匹配。参数指针可以在参数列表中随意地来回移动，但必须在va_start() …
va_end()之内。

自定义调试打印宏，输出当前文件名与行号                                                                                                 

#define _DEBUG_TRACE_CMH_ 2
#if 0 != _DEBUG_TRACE_CMH_
#include <cstdio>
#endif

#if 1==_DEBUG_TRACE_CMH_    //普通打印
#define TRACE_CMH printf
#elif 2==_DEBUG_TRACE_CMH_  //打印文件名、行号
#define TRACE_CMH(fmt,...) \
printf("%s(%d): "##fmt, __FILE__, __LINE__, ##__VA_ARGS__)
#elif 3==_DEBUG_TRACE_CMH_  //打印文件名、行号、函数名
#define TRACE_CMH(fmt,...) \
printf("%s(%d)-<%s>: "##fmt, __FILE__, __LINE__, __FUNCTION__, ##__VA_ARGS__)
#else
#define TRACE_CMH
#endif //_TRACE_CMH_DEBUG_

1) __VA_ARGS__  
是一个可变参数的宏，这个可宏是新的C99规范中新增的，目前似乎gcc和VC6.0之后的都支持（VC6.0的编译器不支持）。宏前面加上##的作用在于，当可变参数的个数为0时，这里的##起到把前面多余的","去掉的作用。
2) __FILE__   
宏在预编译时会替换成当前的源文件名
3) __LINE__  
宏在预编译时会替换成当前的行号
4) __FUNCTION__  
宏在预编译时会替换成当前的函数名称

参考文档：

Win32开发之Format
MessageBox 详解

http://www.cnblogs.com/hanyonglu/archive/2011/04/19/2020738.html

va_start和va_end使用详解

http://www.cnblogs.com/hanyonglu/archive/2011/05/07/2039916.html