_vsnprintf是C语言库函数之一,属于可变参数。用于向字符串中打印数据、数据格式用户自定义。头文件是#include <stdarg.h>。
参数说明:
-
char *str [out],把生成的格式化的字符串存放在这里.
-
size_t size [in],str可接受的最大字符数 [1] (非字节数,UNICODE一个字符两个字节),防止产生数组越界.
-
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
实例:
#include <stdio.h>
#include <stdlib.h>
#include <stdarg.h>
char *make_message(const char *fmt,...)
{
/* 初始时假设我们只需要不超过100字节大小的空间 */
int n,size = 100;
char *p;
va_list ap;
if ( (p = (char *) malloc(size*sizeof(char))) == 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*sizeof(char))) == NULL)
return NULL;
}
}
int main()
{
/* 调用上面的函数 */
char* str = make_message("%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;
}
版权声明:本文内容由互联网用户自发贡献,该文观点与技术仅代表作者本人。本站仅提供信息存储空间服务,不拥有所有权,不承担相关法律责任。如发现本站有涉嫌侵权/违法违规的内容, 请发送邮件至 [email protected] 举报,一经查实,本站将立刻删除。