1.功能介绍
_vsnprintf,C语言库函数之一,属于可变参数。用于向字符串中打印数据、数据格式用户自定义。
头文件:
#include
函数声明:
int vsnprintf(char *str, size_t size, const char *format, va_list ap);
参数说明:
1. char *str [out], 把生成的格式化的字符串存放在这里.
2. size_t size [in], buffer 可接受的最大字节数,防止产生数组越界.
3. const char *format [in], 指定输出格式的字符串,它决定了你需要提供的可变参数的类型、个数和顺序。
4. va_list ap [in], va_list变量. va:variable-argument:可变参数
函数功能:将可变参数格式化输出到一个字符数组。
用法类似于vsprintf
,不过加了size的限制,防止了内存溢出(size为str所指的存储空间的大小)。
返回值:执行成功,返回写入到字符数组str中的字符个数(不包含终止符),最大不超过size;执行失败,返回负值,并置errno.[1]
备注:
linux
环境下是:vsnprintf
VC6
环境下是:_vsnprintf
2.使用
vsnprintf
和snprintf
是C语言printf
家族函数的成员,相关函数列表如下:
int printf(const char *format, ...); //输出到标准输出
int fprintf(FILE *stream, const char *format, ...); //输出到文件
int sprintf(char *str, const char *format, ...); //输出到字符串str中
int snprintf(char *str, size_t size, const char *format, ...); //按size大小输出到字符串str中
以下函数功能与上面的一一对应相同,只是在函数调用时,把上面的...对应的一个个变量用va_list调用所替代。在函数调用前ap要通过va_start()宏来动态获取。
int vprintf(const char *format, va_list ap);
int vfprintf(FILE *stream, const char *format, va_list ap);
int vsprintf(char *str, const char *format, va_list ap);
int vsnprintf(char *str, size_t size, const char *format, va_list ap);
可变参数列表va_list
宏说明:
void va_start(va_list ap, last);
void va_end(va_list ap);
va_start
与va_end
是成对被调用的,
开始的时候被调用va_start
,获得各输出变量地址
结束的时候被调用va_end
,释放相应的资源
例,通过vsnprintf()
实现snprintf()
功能:(更多详情可参阅linux man va_start手册)
#include
#include
int my_snprintf(char *s, int size, const char *fmt, ...) //该自定义函数,与系统提供的snprintf()函数相同。
{
va_list ap;
int n=0;
va_start(ap, fmt); //获得可变参数列表
n=vsnprintf (s, size, fmt, ap); //写入字符串s
va_end(ap); //释放资源
return n; //返回写入的字符个数
}
int main() {
char str[1024];
my_snprintf( str, sizeof(str), "%d,%d,%d,%d",5,6,7,8);
printf("%s\n",str);
return 0;
}