_vfprintf_p、_vfprintf_p_l、_vfwprintf_p、_vfwprintf_p_l

發行項
06/09/2015

將格式化輸出利用指標寫入至參數清單，並能指定參數使用的順序。

int _vfprintf_p(
   FILE *stream,
   const char *format,
   va_list argptr 
);
int _vfprintf_p_l(
   FILE *stream,
   const char *format,
   locale_t locale,
   va_list argptr 
);
int _vfwprintf_p(
   FILE *stream,
   const wchar_t *format,
   va_list argptr 
);
int _vfwprintf_p_l(
   FILE *stream,
   const wchar_t *format,
   locale_t locale,
   va_list argptr 
);

參數

stream
指向 FILE 結構的指標。
format
格式規範。
argptr
參數清單的指標。
locale
要使用的地區設定。

如需詳細資訊，請參閱格式規格。

傳回值

_vfprintf_p 和 _vfwprintf_p 回傳寫入的字元數，不包含結尾的空字元，或者在輸出發生錯誤時回傳一個負值。

備註

這些函式都接受指標引數清單，然後格式和寫入 stream的特定資料。這些函式與 _vfprint_s 和 _vfwprint_s 版本不同的地方只有於它們支援位置參數。如需詳細資訊，請參閱printf_p 位置參數。

_vfwprintf_p 是 _vprintf_p的寬字元版本;如果資料流在 ANSI 模式中開啟，則兩個函式的作用完全相同。 _vprintf_p 目前不支援輸出到 UNICODE 串流。

這些有 _l 尾碼的函式版本是一樣的，不同之處在於會使用傳入的地區設定，而不使用目前的執行緒地區設定。

安全性提示
確認 format 不是使用者定義的字串。如需詳細資訊，請參閱 Avoiding Buffer Overruns 。

如果 stream 或 format 為 null 指標，或是如果格式字串包含無效的格式化字元，無效的參數會叫用處理常式，如參數驗證中所述。如果允許繼續執行，函式回傳 -1 並將 errno 設置為 EINVAL 。

一般文字常式對應

TCHAR.H 常式	_UNICODE & _MBCS 未定義	_MBCS 已定義	_UNICODE 已定義
_vftprintf_p	_vfprintf_p	_vfprintf_p	_vfwprintf_p
_vftprintf_p_l	_vfprintf_p_l	_vfprintf_p_l	_vfwprintf_p_l

需求

常式	必要的標頭	選擇性的標頭檔
_vfprintf_p, _vfprintf_p_l	<stdio.h> 和 <stdarg.h>	<varargs.h>*
_vfwprintf_p, _vfwprintf_p_l	<stdio.h> 或 <wchar.h>, 及 <stdarg.h>	<varargs.h>*

* 要求 UNIX V 相容性。

如需其他相容性資訊，請參閱＜簡介＞中的相容性。

.NET Framework 對等用法

不適用。若要呼叫標準 C 函式，請使用 PInvoke。如需詳細資訊，請參閱平台叫用範例。

請參閱

參考

fprintf、_fprintf_l、fwprintf、_fwprintf_l

printf、_printf_l、wprintf、_wprintf_l

sprintf、_sprintf_l、swprintf、_swprintf_l、__swprintf_l

va_arg、va_copy、va_end、va_start

printf_p 位置參數

_fprintf_p、_fprintf_p_l、_fwprintf_p、_fwprintf_p_l

_vsprintf_p、_vsprintf_p_l、_vswprintf_p、_vswprintf_p_l

_sprintf_p、_sprintf_p_l、_swprintf_p、_swprintf_p_l