简介
作用:使用vsnprintf()用于向一个字符串缓冲区打印格式化字符串,且可以限定打印的格式化字符串的最大长度。
此函数需要C99或者C++11及以上版本才能支持。
int vsnprintf (char * sbuf, size_t n, const char * format, va_list arg );
参数sbuf:用于缓存格式化字符串结果的字符数组
参数n:限定最多打印到缓冲区sbuf的字符的个数为n-1个,因为vsnprintf还要在结果的末尾追加\0。如果格式化字符串长度大于n-1,则多出的部分被丢弃。如果格式化字符串长度小于等于n-1,则可以格式化的字符串完整打印到缓冲区sbuf。一般这里传递的值就是sbuf缓冲区的长度。
参数format:格式化限定字符串
参数arg:可变长度参数列表
返回:如果没有发生截断,则代表成功打印到sbuf中的字符的个数,不包括末尾追加的\0。如果发生了截断,则代表在不限制打印字符个数的情况下可以写入的字符个数,不包括末尾追加的\0。如果格式化解析失败,则返回负数。
例程
#include <stdio.h>
#include <string.h>
#include <stdarg.h>
#define SBUF_SIZE 6
char sbuf[SBUF_SIZE];
void MyPrintF( const char * format, ... )
{
int ret;
va_list args;
va_start (args, format);
ret = vsnprintf (sbuf,SBUF_SIZE,format, args);
va_end (args);
printf("ret=%d,str=%s\n",ret,sbuf);
}
int main()
{
MyPrintF("12345"); //刚好放下,返回值为5
MyPrintF("123456"); //截去了6 ,返回值为6
MyPrintF("12345678"); //截去了678 ,返回值为8
return 0;
}