函数头文件:
#include stdio.h
函数声明:
int_vsnprintf(char*str,size_t size,const char* format,va_list ap );
参数说明char *str [out],将生成的格式化字符串存储在此处。
size_t size [in]、str允许的最大字符数[1] (非字节数,UNICODE字符为2字节) )、防止数组越界的发生。
const char *format [in]是指定输出格式的字符串,该输出格式确定要提供的可变参数的类型、数量和顺序。
va_list ap [in],va_list变量. va:variable-argument:可变参数
函数功能:将可变参数格式化为字符数组并输出。
用法与vsprintf类似,但添加了size限制,以防止内存溢出,其中size是由str指定的存储空间大小。
返回值:返回成功执行并最终生成的字符串的长度。 如果生成的字符串的长度大于size,则将字符串的第一个size字符复制到str并返回原始字符串的长度。 (不包括终止符号。 )执行失败。 返回负值,errno.[2]
备注:
在linux环境中为:vsnprintf
VC6环境中为:_vsnprintf
使用示例1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
#includestdio.h
#includestdarg.h
intmon_log(char*format,) )。
{
charstr_tmp[50];
inti=0;
va_listvArgList; 定义va_list类型的变量,该变量是指向//参数的指针。
va_start(Varglist,format ); 用va_start宏初始化变量。 此宏的第二个参数是第一个可变参数之前的参数,是固定参数
I=_vsnprintf(str_tmp,50,format,vArgList ); //注意不要错过前面的)
va_end(vArglist; va_end宏结束可变参数的获取
returni; //返回参数的字符数之间有逗号间隔
}
//调用上面的函数
voidmain () )
{
inti=mon_log(‘%s,%d,%d,%d ‘,’ asd ‘,2,3,4 );
printf(%d(n ),I );
}
输出9。
asd,2,3,4
123456789 (共9个字符,包括空格和逗号计算(2) )。
介绍va_start和va_end的使用和原理。
以前的帖子Format MessageBox的详细解析使用了va_start和va_end这两个宏,但对它们也只有一般的了解。
在介绍这两个宏之前,让我们先看一下在c中传递函数参数的用法和原理:
在1.c中,如果无法列出传递函数的所有参数的类型和数量,则可以用省略号指定参数表
voidfoo(…;
voidfoo(parm_list,
这种方式和我们以前知道的差不多,但请记住这是C中的一种传记形式。 稍后再用那个。
2 .函数参数的传递原理
函数参数作为数据结构:堆栈进行访问,从右到左进行堆栈。
首先是参数的存储器存储形式。 参数存储在内存的堆栈中,在执行函数时从末尾进入堆栈。 因此,堆栈底部的地址、顶部的地址,举例如下。
voidfunc(intx,float y,char z );
那么,调用函数时,是实参char z先进堆栈,其次是float y,最后是int x。 因此,内存中变量的存储顺序为x-y-z。 因此,理论上,只要检测出其中一个变量的地址,知道其他变量的类型,通过指针移位运算,总是可以在芋式中找到其他输入变量。
stdarg.h中重要宏的定义如下。
r> typedef char* va_list;
void va_start ( va_list ap, prev_param ); /* ANSI version */
type va_arg ( va_list ap, type );
void va_end ( va_list ap );
va_list 是一个字符指针,可以理解为指向当前参数的一个指针,取参必须通过这个指针进行。
<Step 1> 在调用参数表之前,定义一个 va_list 类型的变量,(假设va_list 类型变量被定义为ap);
<Step 2> 然后应该对ap 进行初始化,让它指向可变参数表里面的第一个参数,这是通过 va_start 来实现的,第一个参数是 ap 本身,第二个参数是在变参表前面紧挨着的一个变量,即“…”之前的那个参数;
<Step 3> 然后是获取参数,调用va_arg,它的第一个参数是ap,第二个参数是要获取的参数的指定类型,然后返回这个指定类型的值,并且把 ap 的位置指向变参表的下一个变量位置;
<Step 4> 获取所有的参数之后,我们有必要将这个 ap 指针关掉,以免发生危险,方法是调用 va_end,他是输入的参数 ap 置为 NULL,应该养成获取完参数表之后关闭指针的习惯。说白了,就是让我们的程序具有健壮性。通常va_start和va_end是成对出现。
例如 int max(int n, …); 其函数内部应该如此实现:
#include <iostream.h>
void fun(int a, …)
{
int *temp = &a;
temp++;
for (int i = 0; i < a; ++i)
{
cout << *temp << endl;
temp++;
}
}
int main()
{
int a = 1;
int b = 2;
int c = 3;
int d = 4;
fun(4, a, b, c, d);
system(“pause”);
return 0;
}
Output::
1
2
3
4
3:获取省略号指定的参数
在函数体中声明一个va_list,然后用va_start函数来获取参数列表中的参数,使用完毕后调用va_end()结束。像这段代码:
void TestFun(char* pszDest, int DestLen, const char* pszFormat, …)
{
va_list args;
va_start(args, pszFormat); //一定要“…”之前的那个参数
_vsnprintf(pszDest, DestLen, pszFormat, args);
va_end(args);
}
4.演示如何使用参数个数可变的函数,采用ANSI标准形式
#include 〈stdio.h〉
#include 〈string.h〉
#include 〈stdarg.h〉
/*函数原型声明,至少需要一个确定的参数,注意括号内的省略号*/
int demo( char, … );
void main( void )
{
demo(“DEMO”, “This”, “is”, “a”, “demo!”, “”);
}
/*ANSI标准形式的声明方式,括号内的省略号表示可选参数*/
int demo( char msg, … )
{
/*定义保存函数参数的结构*/
va_list argp;
int argno = 0;
char para;
/*argp指向传入的第一个可选参数,msg是最后一个确定的参数*/
va_start( argp, msg );
while (1)
{
para = va_arg( argp, char);
if ( strcmp( para, “”) == 0 )
break;
printf(“Parameter #%d is: %s\n”, argno, para);
argno++;
}
va_end( argp );
/*将argp置为NULL*/
return 0;
}
以上是对va_start和va_end的介绍。