vfprintf、_vfprintf_l、vfwprintf、_vfwprintf_l

撰寫使用指標引數清單的格式化的輸出。 這些函式更安全版本存在。 see vfprintf_s、_vfprintf_s_l、vfwprintf_s、_vfwprintf_s_l.

int vfprintf(
   FILE *stream,
   const char *format,
   va_list argptr 
);
int _vfprintf_l(
   FILE *stream,
   const char *format,
   locale_t locale,
   va_list argptr 
);
int vfwprintf(
   FILE *stream,
   const wchar_t *format,
   va_list argptr 
);
int _vfwprintf_l(
   FILE *stream,
   const wchar_t *format,
   locale_t locale,
   va_list argptr 
);

參數

• stream
  指標FILE結構。

• format
  格式規格。

• argptr
  引數清單的指標。

• locale
  若要使用地區設定。

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

傳回值

vfprintf與vfwprintf傳回寫入的字元數，不包含結束的 null 字元或為負值，如果發生輸出錯誤。 如果其中一個stream或format是空值的指標，不正確的參數處理常式會叫用，如所述參數驗證。 若要繼續，允許執行，函數會傳回-1，並設定errno到EINVAL。

有關這些及其他錯誤碼資訊，請參閱 _doserrno、 errno、 _sys_errlist，以及 _sys_nerr。

備註

每個函式會使用指標引數] 清單中，然後格式化並寫入至指定的資料stream。

vfwprintf是的寬字元版本vfprintf。 如果資料流以 ANSI 模式開啟兩個函式的行為都相同。 vfprintf目前不支援輸出成 UNICODE 資料流。

使用這些函式的版本_l尾碼完全相同，不同之處在於它們使用傳遞中而不是目前執行緒的地區設定的地區設定參數。

安全性提示
請確定format不是使用者定義的字串。如需詳細資訊，請參閱避免緩衝區滿溢，。

泛用文字常式對應

TCHAR。H 常式	_UNICODE & 未定義的 _MBCS	定義的 _MBCS	定義 _unicode 之後
_vftprintf	vfprintf	vfprintf	vfwprintf
_vftprintf_l	_vfprintf_l	_vfprintf_l	_vfwprintf_l

需求

常式	所需的標頭	選擇性標頭
vfprintf, _vfprintf_l	<stdio.h> 和 <stdarg.h>	<varargs.h> *
vfwprintf, _vfwprintf_l	<stdio.h> 或 <wchar.h>，和 <stdarg.h>	<varargs.h> *

* UNIX V 相容性的必要項。

其他的相容性資訊，請參閱相容性在簡介中。

.NET Framework 對等用法

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

請參閱

參考

資料流 I/O

vprintf 函式

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