vprintf_s、 _vprintf_s_l、 vwprintf_s、 _vwprintf_s_l

將格式化的輸出使用指標的引數清單。 這些是 vprintf、 _vprintf_l、 vwprintf、 _vwprintf_l 的安全性增強版本，如 安全性功能，則在 CRT 中 中所述。

int vprintf_s(
   const char *format,
   va_list argptr 
);
int _vprintf_s_l(
   const char *format,
   locale_t locale,
   va_list argptr 
);
int vwprintf_s(
   const wchar_t *format,
   va_list argptr 
);
int _vwprintf_s_l(
   const wchar_t *format,
   locale_t locale,
   va_list argptr 
);

參數

• format
  格式規範。

• argptr
  參數清單的指標。

• locale
  使用的地區設定。

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

傳回值

vprintf_s 和 vwprintf_s 回傳寫入的字元數，不包含結尾的空字元，或者在輸出發生錯誤時回傳一個負值。 如果 format 為 null 指標，則為，如果格式字串包含無效的格式化字元，無效的參數叫用處理常式，如 參數驗證中所述。 如果允許繼續執行，函式回傳 -1 並將 errno 設置為 EINVAL 。

如需這些屬性和其他錯誤碼的詳細資訊，請參閱 _doserrno、errno、_sys_errlist 和 _sys_nerr。

備註

這些函式都接受指標引數清單，然後格式和寫入 stdout的特定資料。

這些函式的安全版本與 vprintf 和 vwprintf 只在於安全版本檢查格式字串包含有效格式字元。

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

這些函式的以 _l 後綴版本相同，但使用傳遞的地區設定參數而非目前執行緒的地區設定。

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

泛用文字常式對應

TCHAR.H 常式	未定義 _UNICODE & _MBCS	已定義 _MBCS	已定義 _UNICODE
_vtprintf_s	vprintf_s	vprintf_s	vwprintf_s
_vtprintf_s_l	_vprintf_s_l	_vprintf_s_l	_vwprintf_s_l

需求

程序	必要的標頭檔	選擇性的標頭檔
vprintf_s, _vprintf_s_l	<stdio.h> 和 <stdarg.h>	<varargs.h>*
vwprintf_s, _vwprintf_s_l	<stdio.h> 或 <wchar.h> 和 <stdarg.h>	<varargs.h>*

* 要求 UNIX V 相容性。

主控台 Windows 市集 應用程式不支援。 標準資料流控制代碼與主控台， stdin， stdout和 stderr，在這種情況下， C 執行階段函式在 Windows 市集 應用程式之前，可以使用它們必須重新導向。 如需其他相容性資訊，請參閱入門介紹中的 相容性 (Compatibility) 。

.NET Framework 對等用法

System::Console::Write

請參閱

參考

資料流 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_end va_start