C語言 vwprintf用法及代碼示例

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

用法:

int vwprintf (const wchar_t* format, va_list arg);

將格式化的數據從變量參數列表打印到標準輸出

寫入由C指向的C寬字符串格式到標準輸出(stdout)，替換任何格式說明符在相同的方式printf可以，但是使用由變量標識的變量參數列表中的元素arg而不是其他函數參數。

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

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

寬字符的外部表示stdout是多字節字符：這些字符的獲取方式就像wcrtomb被稱為轉換每個寬字符(使用流的內部mbstate_t目的)。

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

參數

format: 包含格式字符串的C寬字符串，其格式與格式在printf(參考printf有關詳細信息)。
請注意，所有格式說明符的含義均與中的相同。printf;所以，%lc應該用來寫寬字符(而不是%c)，也%ls應該用於寬字符串(而不是%s)。
arg: 一個值，該值標識用初始化的變量參數列表va_start。
va_list是在中定義的特殊類型<cstdarg>。

返回值

成功後，將返回寫入的字符總數。

如果發生寫入錯誤，則錯誤指示(ferror)設置，並返回負數。

如果在寫入寬字符時發生多字節字符編碼錯誤，errno被設定為EILSEQ並返回負數。

示例

/* vwprintf example */
#include <stdarg.h>
#include <wchar.h>

void WriteWideFormatted ( const wchar_t * format, ... )
{
  va_list args;
  va_start (args, format);
  vwprintf (format, args);
  va_end (args);
}

int main ()
{
   WriteWideFormatted (L"Call with %d variable argument.\n",1);
   WriteWideFormatted (L"Call with %d variable %ls.\n",2,L"arguments");

   return 0;
}

輸出：

Call with 1 variable argument.
Call with 2 variable arguments.

相關用法

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