C语言库函数之 int vsnprintf(char *str, size_t size, const char *format, va_list ap);
_vsnprintf，C语言库函数之一，属于可变参数。用于向字符串中打印数据、数据格式用户自定义。
头文件:
#include
函数声明:
int vsnprintf(char *str, size_t size, const char *format, va_list ap);
参数说明:
- char *str [out],把生成的格式化的字符串存放在这里.
- size_t size [in], buffer可接受的最大字节数,防止产生数组越界.
- const char *format [in], 指定输出格式的字符串，它决定了你需要提供的可变参数的类型、个数和顺序。
- va_list ap [in], va_list变量. va:variable-argument:可变参数
函数功能：将可变参数格式化输出到一个字符数组。
用法类似于vsprintf，不过加了size的限制，防止了内存溢出（size为str所指的存储空间的大小）。
返回值：执行成功，返回写入到字符数组str中的字符个数（不包含终止符），最大不超过size；执行失败，返回负值，并置errno.[1]
备注:
linux环境下是:vsnprintf
VC6环境下是:_vsnprintf
用法实例：
int mon_log(char* format, ...)
{
va_listvArgList; //定义一个va_list型的变量,这个变量是指向参数的指针.
va_start(vArgList, format); //用va_start宏初始化变量,这个宏的第二个参数是第一个可变参数的前一个参数,是一个固定的参数.
_vsnprintf(str_tmp, 3, format, vArgList); //注意,不要漏掉前面的_
va_end(vArgList); //用va_end宏结束可变参数的获取
return 0;
}
//调用上面的函数
mon_log("%d,%d,%d,%d", 1,2,3,4);
返回值用法：
#include
#include
#include
char *
make_message(const char *fmt, ...) {
/* 初始时假设我们只需要不超过100字节大小的空间 */
int n, size = 100;
char *p;
va_list ap;
if ((p = (char *)malloc(size)) == NULL)
return NULL;
while (1) {
/* 尝试在申请的空间中进行打印操作 */
va_start(ap, fmt);
n = vsnprintf (p, size, fmt, ap);
va_end(ap);
/* 如果vsnprintf调用成功，返回该字符串 */
if (n > -1 && n < size)
return p;
/* vsnprintf调用失败(n<0)或者p的空间不足够容纳size大小的字符串(n>=size)，尝试申请更大的空间*/
size *= 2; /* 两倍原来大小的空间 */
if ((p = (char *)realloc(p, size)) == NULL)
return NULL;
}
}
int main() {
/* 调用上面的函数 */
char* str = make_message("%d,%d,%d,%d",5,6,7,8);
printf("%s\n",str);
free(str); // we allocate the memory in the make_message function, so we should release it by caller(main function).
return 0;
}