可变参数格式化输出到一个字符数组 (stdarg.h)

1.功能介绍

_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], 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 <stdio.h>
#include <stdarg.h>

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;
}