C语言 vsnprintf用法及代码示例

C语言stdio头文件(stdio.h)中vsnprintf函数的用法及代码示例。

用法:

int vsnprintf (char * s, size_t n, const char * format, va_list arg );

将格式化的数据从变量参数列表写入大小已设置的缓冲区

组成一个具有相同文本的字符串，如果格式用于printf，但使用由变量标识的变量参数列表中的元素arg而不是其他函数参数并将结果内容存储为C字串在所指向的缓冲区中s(服用n作为要填充的最大缓冲区容量)。

如果结果字符串长于n-1字符，其余的字符将被丢弃而不存储，而是计算该函数返回的值。

在内部，该函数从由以下项标识的列表中检索参数：arg仿佛va_arg被用于它，因此状态arg可能会因调用而改变。

在任何情况下，arg应该已经被初始化va_start在调用之前的某个时间点，预计它将被释放va_end调用结束后的某个时间点。

参数

s: 指向存储结果C-string的缓冲区的指针。
缓冲区的大小至少应为n字符。
n: 缓冲区中要使用的最大字节数。
生成的字符串的长度最大为n-1，为其他终止空字符留出空间。
size_t是无符号整数类型。
format: 包含格式字符串的C字符串，其格式与格式在printf(参考printf有关详细信息)。
arg: 一个值，该值标识用初始化的变量参数列表va_start。
va_list是在中定义的特殊类型<cstdarg>。

返回值

如果要写的字符数n足够大，不算终止空字符。
如果发生编码错误，则返回负数。
请注意，仅当此返回值是非负且小于n，字符串已被完全写入。

示例

/* vsnprintf example */
#include <stdio.h>
#include <stdarg.h>

void PrintFError ( const char * format, ... )
{
  char buffer[256];
  va_list args;
  va_start (args, format);
  vsnprintf (buffer,256,format, args);
  perror (buffer);
  va_end (args);
}

int main ()
{
   FILE * pFile;
   char szFileName[]="myfile.txt";

   pFile = fopen (szFileName,"r");
   if (pFile == NULL)
     PrintFError ("Error opening '%s'",szFileName);
   else
   {
     // file successfully open
     fclose (pFile);
   }
   return 0;
}

在此示例中，如果文件myfile.txt不存在，perror被调用以显示类似于以下内容的错误消息：

Error opening file 'myfile.txt': No such file or directory

相关用法

注：本文由纯净天空筛选整理自C标准库大神的英文原创作品 C vsnprintf function。非经特殊声明，原始代码版权归原作者所有，本译文未经允许或授权，请勿转载或复制。