std::vwprintf, std::vfwprintf, std::vswprintf

 

C++

編譯器支援

自由（freestanding）與宿主（hosted）

語言

標準庫

標準庫標頭檔案

具名要求

特性測試宏 (C++20)

語言支援庫

概念庫 (C++20)

診斷庫

記憶體管理庫

超程式設計庫 (C++11)

通用工具庫

容器庫

迭代器庫

範圍庫 (C++20)

演算法庫

字串庫

文字處理庫

數值庫

日期和時間庫

輸入/輸出庫

檔案系統庫 (C++17)

併發支援庫 (C++11)

執行控制庫 (C++26)

技術規範

符號索引

外部庫

 

輸入/輸出庫

I/O 操縱器

列印函式 (C++23)

C 風格 I/O

緩衝區

basic_streambuf

basic_filebuf

basic_stringbuf

basic_spanbuf (C++23)

strstreambuf (C++98/26*)

basic_syncbuf (C++20)

流

抽象

ios_base

basic_ios

basic_istream

basic_ostream

basic_iostream

檔案 I/O

basic_ifstream

basic_ofstream

basic_fstream

字串 I/O

basic_istringstream

basic_ostringstream

basic_stringstream

陣列 I/O

basic_ispanstream (C++23)

basic_ospanstream (C++23)

basic_spanstream (C++23)

istrstream (C++98/26*)

ostrstream (C++98/26*)

strstream (C++98/26*)

同步輸出

basic_osyncstream (C++20)

型別

streamoff

streamsize

fpos

錯誤類別介面

iostream_category (C++11)

io_errc (C++11)

 

C 風格 I/O

型別和物件
FILE fpos_t	stdinstdoutstderr
函式
檔案訪問 fopen freopen fclose fflush fwide setbuf setvbuf 直接輸入/輸出 fread fwrite 非格式化輸入/輸出 fgetcgetc fgets fputcputc fputs getchar gets (直到 C++14) putchar puts ungetc fgetwcgetwc fgetws fputwcputwc fputws getwchar putwchar ungetwc 格式化輸入 scanffscanfsscanf vscanfvfscanfvsscanf (C++11起)(C++11起)(C++11起)     wscanffwscanfswscanf vwscanfvfwscanfvswscanf (C++11起)(C++11起)(C++11起)	格式化輸出 printffprintfsprintfsnprintf (C++11起) vprintfvfprintfvsprintfvsnprintf (C++11起)     wprintffwprintfswprintf vwprintfvfwprintfvswprintf 檔案定位 ftell fgetpos fseek fsetpos rewind 錯誤處理 clearerr feof ferror perror 檔案操作 remove rename tmpfile tmpnam

 

在標頭檔案 <cwchar> 中定義
int vwprintf( const wchar_t* format, va_list vlist );	(1)
int vfwprintf( std::FILE* stream, const wchar_t* format, va_list vlist );	(2)
int vswprintf( wchar_t* buffer, std::size_t buf_size, const wchar_t* format, va_list vlist );	(3)

從 vlist 定義的位置載入資料，將其轉換為對應的寬字串並把結果寫入各種輸出目標。

1) 將結果寫入 stdout。

2) 將結果寫入檔案流 stream。

3) 將結果寫入寬字串 buffer。最多寫入 size-1 個寬字元，後跟空寬字元。

引數

stream	-	要寫入的輸出寬流
buffer	-	指向要寫入的寬字串的指標
buf_size	-	要寫入的最大寬字元數
format	-	指向以空字元終止的寬字串的指標，指定如何解釋資料
vlist	-	包含要列印資料的可變引數列表。

format 字串由普通寬字元（除了 %）組成，這些字元按原樣複製到輸出流中，以及轉換規範。每個轉換規範具有以下格式

• 前導 % 字元。

• (可選) 一個或多個修改轉換行為的標誌

• -: 轉換結果在欄位內左對齊（預設情況下右對齊）。
• +: 有符號轉換的符號總是前置在轉換結果之前（預設情況下，結果只有在為負時才前置減號）。
• 空格: 如果有符號轉換的結果不以符號字元開頭，或者為空，則在結果前置空格。如果存在 + 標誌，則忽略此標誌。
• #: 執行轉換的替代形式。具體效果請參見下表，否則行為未定義。
• 0: 對於整數和浮點數轉換，使用前導零填充欄位而不是空格字元。對於整數，如果明確指定了精度，則忽略此標誌。對於使用此標誌的其他轉換，會導致未定義行為。如果存在 - 標誌，則忽略此標誌。

• (可選) 整數值或 *，指定最小欄位寬度。如果需要，結果會用空格字元（預設）在右對齊時左側填充，或在左對齊時右側填充。當使用 * 時，寬度由型別為 int 的額外引數指定，該引數出現在要轉換的引數之前，如果提供了精度引數，則出現在精度引數之前。如果引數值為負，則等同於指定 - 標誌和正欄位寬度（注意：這是最小寬度：值永不截斷。）。

• (可選) . 後跟整數或 *，或兩者皆無，用於指定轉換的精度。當使用 * 時，精度由型別為 int 的額外引數指定，該引數出現在要轉換的引數之前，但如果提供了最小欄位寬度引數，則出現在最小欄位寬度引數之後。如果此引數值為負，則忽略。如果既未指定數字也未指定 *，則精度取為零。精確的精度效果見下表。

• (可選) 長度修飾符，指定引數的大小（與轉換格式說明符結合使用，指定相應引數的型別）。

• 轉換格式說明符。

以下格式說明符可用：

轉換 說明符	解釋	預期 引數型別
長度修飾符→		hh	h	無	l	ll	j	z	t	L
僅自 C++11 起可用→		是				是	是	是	是
%	寫入字面量 %。完整的轉換說明符必須是 %%。	不適用	不適用	不適用	不適用	不適用	不適用	不適用	不適用	不適用
c	寫入單個字元。 引數首先透過呼叫 std::btowc 轉換為 wchar_t。 如果使用 l 修飾符，則 std::wint_t 引數首先轉換為 wchar_t。	不適用	不適用	int	std::wint_t	不適用	不適用	不適用	不適用	不適用
s	寫入字元字串。 引數必須是指向包含以初始移位狀態開始的多位元組字元序列的字元陣列初始元素的指標，該序列轉換為寬字元陣列，如同透過呼叫 std::mbrtowc 並使用零初始化的轉換狀態。 *精度*指定要寫入的最大寬字元數。如果未指定*精度*，則寫入所有寬字元，直到但不包括第一個空終止符。 如果使用 l 說明符，則引數必須是指向 wchar_t 陣列的初始元素的指標。	不適用	不適用	char*	wchar_t*	不適用	不適用	不適用	不適用	不適用
d i	將有符號整數轉換為十進位制表示 [-]dddd。 精度 指定要出現的最小位數。預設精度為 1。 如果轉換值和精度都為 ​0​，則轉換結果為空字元。 對於 z 修飾符，期望的引數型別是 std::size_t 的有符號版本。	signed char	short	int	long	long long	std::intmax_t	※	std::ptrdiff_t	不適用
o	將無符號整數轉換為八進位制表示 oooo。 精度 指定要出現的最小位數。預設精度為 1。 如果轉換值和精度都為 ​0​，則轉換結果為空字元。 在替代實現中，如有必要，精度會增加以寫入一個前導零。在這種情況下，如果轉換值和精度都為 ​0​，則寫入單個 ​0​。	unsigned char	unsigned short	unsigned int	unsigned long	unsigned long long	std::uintmax_t	std::size_t	std::ptrdiff_t 的無符號版本	不適用
x X	將無符號整數轉換為十六進位制表示 hhhh。 對於 x 轉換，使用字母 abcdef。 對於 X 轉換，使用字母 ABCDEF。 精度 指定要出現的最小位數。預設精度為 1。 如果轉換值和精度都為 ​0​，則轉換結果為空字元。 在替代實現中，如果轉換值非零，則在結果前新增 0x 或 0X。									不適用
u	將無符號整數轉換為十進位制表示 dddd。 精度 指定要出現的最小位數。 預設精度為 1。 如果轉換值和精度都為 ​0​，則轉換結果為空字元。									不適用
f F (C++11起)	將浮點數轉換為十進位制表示法，樣式為 [-]ddd.ddd。 精度 指定小數點字元後要出現的準確位數。 預設精度為 6。 在替代實現中，即使後面沒有數字，也會寫入小數點字元。 關於無窮大和非數字的轉換樣式，請參見註釋。	不適用	不適用	double	double (C++11起)	不適用	不適用	不適用	不適用	long double
e E	將浮點數轉換為十進位制指數表示法。 對於 e 轉換，使用樣式 [-]d.ddd e±dd。 對於 E 轉換，使用樣式 [-]d.ddd E±dd。 指數至少包含兩位數字，只有在必要時才使用更多數字。 如果值為 ​0​，則指數也為 ​0​。 精度 指定小數點字元後要出現的準確位數。 預設精度為 6。 在替代實現中，即使後面沒有數字，也會寫入小數點字元。 關於無窮大和非數字的轉換樣式，請參見註釋。	不適用	不適用			不適用	不適用	不適用	不適用
a A (C++11)	將浮點數轉換為十六進位制指數表示法。 對於 a 轉換，使用樣式 [-] 0xh.hhh p±d。 對於 A 轉換，使用樣式 [-] 0Xh.hhh P±d。 如果引數是規範化浮點值，則第一個十六進位制數字不是 0。 如果值為 ​0​，則指數也為 ​0​。 精度 指定十六進位制小數點字元後要出現的準確位數。 預設精度足以精確表示該值。 在替代實現中，即使後面沒有數字，也會寫入小數點字元。 關於無窮大和非數字的轉換樣式，請參見註釋。	不適用	不適用			不適用	不適用	不適用	不適用
g G	根據值和精度，將浮點數轉換為十進位制或十進位制指數表示法。 對於 g 轉換樣式，將執行樣式 e 或 f 的轉換。 對於 G 轉換樣式，將執行樣式 E 或 f(直到 C++11)F(C++11起) 的轉換。 令 P 等於精度（如果非零），如果未指定精度，則為 6，如果精度為 ​0​，則為 1。然後，如果樣式 E 的轉換指數為 X 如果 P > X ≥ −4，則轉換樣式為 f 或 F(C++11起)，精度為 P − 1 − X。 否則，轉換使用樣式 e 或 E，精度為 P − 1。 除非請求替代表示，否則會刪除尾隨零，如果不再有小數部分，也會刪除小數點字元。 關於無窮大和非數字的轉換樣式，請參見註釋。	不適用	不適用			不適用	不適用	不適用	不適用
n	返回此函式呼叫目前已寫入的字元數。 結果被寫入到引數指向的值。 說明符不得包含任何標誌、欄位寬度或精度。 對於 z 修飾符，預期引數型別為 S*，其中 S 是 std::size_t 的有符號版本。	signed char*	short*	int*	long*	long long*	std::intmax_t*	※	std::ptrdiff_t*	不適用
p	寫入一個實現定義的字元序列，定義一個指標。	不適用	不適用	void*	不適用	不適用	不適用	不適用	不適用	不適用
備註
浮點轉換函式將無窮大轉換為 inf 或 infinity。具體使用哪一個由實現定義。 非數字轉換為 nan 或 nan(char_sequence)。具體使用哪一個由實現定義。 轉換 F、E、G、A 輸出 INF、INFINITY、NAN。 用於列印 char、unsigned char、signed char、short 和 unsigned short 的轉換說明符預期預設引數提升後的提升型別，但在列印其值之前，它將被轉換為 char、unsigned char、signed char、short 和 unsigned short。由於呼叫可變引數函式時發生的提升，傳遞這些型別的值是安全的。 固定寬度字元型別（std::int8_t 等）的正確轉換規範定義在標頭檔案 <cinttypes> 中（儘管 PRIdMAX、PRIuMAX 等是 %jd、%ju 等的同義詞）。 記憶體寫入轉換說明符 %n 是格式字串依賴使用者輸入時常見的安全漏洞目標。 每個轉換說明符的操作之後都有一個序列點；這允許在同一變數中儲存多個 %n 結果，或者在極端情況下，在同一呼叫中列印由較早的 %n 修改的字串。 如果轉換說明符無效，則行為未定義。

返回值

1,2) 如果成功，寫入的寬字元數；如果發生錯誤，則為負值。

3) 如果成功，寫入的寬字元數（不包括終止空寬字元），如果發生編碼錯誤或要生成的字元數等於或大於 size，則為負值。

註解

雖然窄字串提供了 std::vsnprintf，可以確定所需的輸出緩衝區大小，但寬字串沒有等效的函式，為了確定緩衝區大小，程式可能需要呼叫 std::vswprintf，檢查結果值，並重新分配更大的緩衝區，然後再次嘗試直到成功。

參閱

vprintfvfprintfvsprintfvsnprintf (C++11起)	將格式化輸出列印到 stdout、檔案流或緩衝區 使用可變引數列表 (函式)
wprintffwprintfswprintf	向 stdout、檔案流或緩衝區列印格式化的寬字元輸出 (函式)
C 文件 關於 vwprintf, vfwprintf, vswprintf