int vsnprintf (char * s, size_t n, const char * format, va_list arg );
描述:
将格式化数据从可变参数列表写入大小缓冲区,如果在printf上使用格式,则使用相同的文本组成字符串,但使用由arg标识的变量参数列表中的元素而不是附加的函数参数,并将结果内容作为C字符串存储在s指向的缓冲区中 (以n为最大缓冲区容量来填充)。如果结果字符串的长度超过了n-1个字符,则剩余的字符将被丢弃并且不被存储,而是被计算为函数返回的值。在内部,函数从arg标识的列表中检索参数,就好像va_arg被使用了一样,因此arg的状态很可能被调用所改变。在任何情况下,arg都应该在调用之前的某个时刻由va_start初始化,并且在调用之后的某个时刻,预计会由va_end释放。
参数:
s
指向存储结果C字符串的缓冲区的指针。
缓冲区应至少有n个字符的大小。
n
在缓冲区中使用的最大字节数。
生成的字符串的长度至多为n-1,为额外的终止空字符留下空间。
size_t是一个无符号整数类型。
format
包含格式字符串的C字符串,其格式字符串与printf中的格式相同
arg
标识使用va_start初始化的变量参数列表的值。
va_list是在中定义的特殊类型。
返回值:
如果n足够大,则会写入的字符数,不包括终止空字符。
如果发生编码错误,则返回负数。
注意,只有当这个返回值是非负值且小于n时,字符串才被完全写入。
参考例子
#include <stdio.h>
#include <stdarg.h>
#define MAXLEN 10
int mon_log(char* format, ...)
{
char str_tmp[MAXLEN];
int i=0,j=0;
va_list vArgList;
va_start (vArgList, format);
i=vsnprintf(str_tmp, MAXLEN, format, vArgList);
va_end(vArgList);
printf("%s", str_tmp);
for(j=0;j<MAXLEN;j++)
{
printf("%d ", str_tmp[j]);
}
printf("\n");
return i;
}
void main()
{
int i=mon_log("%s,%d,%d,%c","abc",2,3,'\n');
printf("%d\n",i);
}
运行结果
分析: