_vsnprintf在可变参数打印中的用法

Posted 2020-08-31 Boblim

_vsnprintf，C语言库函数之一，属于可变参数。用于向字符串中打印数据、数据格式用户自定义。

 

函数简介

编辑

头文件:

#include <stdarg.h>

函数声明:

int _vsnprintf(char* str, size_t size, const char* format, va_list ap);

参数说明:

1. char *str [out],把生成的格式化的字符串存放在这里.
2. size_t size [in], str可接受的最大字符数[1]  (非字节数，UNICODE一个字符两个字节),防止产生数组越界.
3. const char *format [in], 指定输出格式的字符串，它决定了你需要提供的可变参数的类型、个数和顺序。
4. va_list ap [in], va_list变量. va:variable-argument:可变参数

函数功能：将可变参数格式化输出到一个字符数组。

用法类似于vsprintf，不过加了size的限制，防止了内存溢出（size为str所指的存储空间的大小）。

返回值：执行成功，返回写入到字符数组str中的字符个数（不包含终止符），最大不超过size；执行失败，返回负值，并置errno.[2] 

备注:

linux环境下是:vsnprintf

VC6环境下是:_vsnprintf

 

用法实例

 1 #include <stdio.h>
 2 #include <stdarg.h>
 3 int mon_log(char* format, ...)
 4 {
 5 char str_tmp[50];
 6 int i=0;
 7 va_list vArgList;                            //定义一个va_list型的变量,这个变量是指向参数的指针.
 8 va_start (vArgList, format);                 //用va_start宏初始化变量,这个宏的第二个参数是第一个可变参数的前一个参数,是一个固定的参数
 9 i=_vsnprintf(str_tmp, 50, format, vArgList); //注意,不要漏掉前面的_
10 va_end(vArgList);                            //用va_end宏结束可变参数的获取
11 return i;                                    //返回参数的字符个数中间有逗号间隔
12 }
13 //调用上面的函数
14 void main()　
15 {
16     int i=mon_log("%s,%d,%d,%d","asd",2,3,4);
17     printf("%d\n",i);
18 }

输出 9。

asd,2,3,4

123456789 （共9个字符，间隔符逗号计算在内）[2] 

返回值用法

 1 #include <stdio.h>
 2 #include <stdlib.h>
 3 #include <stdarg.h>
 4 char *make_message(const char *fmt, ...) 
 5 {
 6     /* 初始时假设我们只需要不超过100字节大小的空间 */
 7     int n, size = 100;
 8     char *p;
 9     va_list ap;
10     if ( (p = (char *) malloc(size*sizeof(char))) == NULL)
11     return NULL;
12     while (1) 
13     {
14         /* 尝试在申请的空间中进行打印操作 */
15         va_start(ap, fmt);
16         n = vsnprintf (p, size, fmt, ap);
17         va_end(ap);
18         /* 如果vsnprintf调用成功，返回该字符串 */
19         if (n > -1 && n < size)
20         return p;
21         /* vsnprintf调用失败(n<0)，或者p的空间不足够容纳size大小的字符串(n>=size)，尝试申请更大的空间*/
22         size *= 2; /* 两倍原来大小的空间 */
23         if ((p = (char *)realloc(p, size*sizeof(char))) == NULL)
24         return NULL;
25     }
26 }
27 int main() 
28 {
29     /* 调用上面的函数 */
30     char* str = make_message("%d,%d,%d,%d",5,6,7,8);
31     printf("%s\n",str);
32     free(str);
33     /* we allocate the memory in the make_message function, so we should release it by caller(main function). */
34     return 0;
35 }