C語言 vswprintf用法及代碼示例

C語言wchar頭文件(wchar.h)中vswprintf函數的用法及代碼示例。

用法:

int vswprintf (wchar_t * ws, size_t len, const wchar_t * format, va_list arg );

將格式化的數據從變量參數列表寫入大小已設置的緩衝區

組成一個具有相同文本的字符串，如果格式用於wprintf，但使用由變量標識的變量參數列表中的元素arg而不是其他函數參數並將結果內容存儲為C寬弦在所指向的緩衝區中ws(服用倫作為要填充的最大緩衝區容量(以寬字符表示)。

如果結果字符串長於n-1寬字符，其餘字符將被丟棄而不存儲。

在內部，該函數從由以下項標識的列表中檢索參數：arg仿佛va_arg被用於它，因此狀態arg可能會因調用而改變。

在任何情況下，arg應該已經被初始化va_start在調用之前的某個時間點，預計它將被釋放va_end調用結束後的某個時間點。

這是寬字符等價於vsnprintf(<cstdio>)。

參數

ws: 指向緩衝區的指針C寬弦被儲存了。
緩衝區的大小至少應為倫寬字符。
len: 要寫入緩衝區的最大寬字符數。
生成的字符串的長度最大為n-1，留出空間來容納其他終止的null寬字符。
size_t是無符號整數類型。
format: 包含格式字符串的C寬字符串，其格式與格式在printf(參考printf有關詳細信息)。
請注意，所有格式說明符的含義均與中的相同。printf;所以，%lc應該用來寫寬字符(而不是%c)，也%ls應該用於寬字符串(而不是%s)。
arg: 一個值，該值標識用初始化的變量參數列表va_start。
va_list是在中定義的特殊類型<cstdarg>。

返回值

成功後，將返回寫入的字符總數。此計數不包括自動附加在字符串末尾的其他null-character。
失敗時返回負數，包括何時將結果字符串寫入其中ws會比n字符。

示例

/* vswprintf example */
#include <stdio.h>
#include <stdarg.h>
#include <wchar.h>

void PrintWide ( const wchar_t * format, ... )
{
  wchar_t buffer[256];
  va_list args;
  va_start ( args, format );
  vswprintf ( buffer, 256, format, args );
  fputws ( buffer, stdout );
  va_end ( args );
}

int main ()
{
   wchar_t str[] = L"test string has %d wide characters.\n";

   PrintWide ( str, wcslen(str) );

   return 0;
}

可能的輸出：

test string has 36 wide characters.

相關用法

注：本文由純淨天空篩選整理自C標準庫大神的英文原創作品 C vswprintf function。非經特殊聲明，原始代碼版權歸原作者所有，本譯文未經允許或授權，請勿轉載或複製。