vsnprintf函数使用

原创已于 2024-07-29 15:37:49 修改 · 2.6w 阅读

112 ·

CC 4.0 BY-SA版权

文章标签：

#c语言 #c++

于 2022-04-12 14:57:55 首次发布

C++ 专栏收录该内容

1 篇文章

订阅专栏

vsnprintf函数是C99和C++11及以上版本支持的一个功能，用于将格式化字符串安全地写入指定大小的缓冲区。它接受一个字符数组、最大允许的字符数、格式化字符串和可变参数列表。如果格式化后的字符串超过缓冲区大小，超出部分将被截断。示例程序展示了如何使用vsnprintf和自定义的MyPrintF函数来打印带有变量的字符串。

简介

作用：使用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;
}