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。非經特殊聲明，原始代碼版權歸原作者所有，本譯文未經允許或授權，請勿轉載或複製。