vprintf、 _vprintf_l、 vwprintf、 _vwprintf_l

發行項
03/27/2013

將格式化的輸出使用指標的引數清單。這些函式更安全的可用版本的詳細資訊，請參閱 vprintf_s、 _vprintf_s_l、 vwprintf_s、 _vwprintf_s_l。

int vprintf(
   const char *format,
   va_list argptr 
);
int _vprintf_l(
   const char *format,
   locale_t locale,
   va_list argptr 
);
int vwprintf(
   const wchar_t *format,
   va_list argptr 
);
int _vwprintf_l(
   const wchar_t *format,
   locale_t locale,
   va_list argptr 
);

參數

format
格式規範。
argptr
參數清單的指標。
locale
使用的地區設定。

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

傳回值

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

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

備註

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

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

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

安全性提示
須確保 format 不是使用者定義的字串。如需詳細資訊，請參閱 Avoiding Buffer Overruns 。請注意偵測到無效的格式字串和錯誤的結果。