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

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.使用

vsnprintfsnprintf是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_startva_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;
}

你可能感兴趣的:(2.可变参数格式化输出到一个字符数组 (stdarg.h))