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 市集 應用程式中使用它們。 如需其他相容性資訊，請參閱相容性。

.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_copy、va_end、va_start