vprintf、_vprintf_l、vwprintf、_vwprintf_l

發行項
06/09/2015

使用指向一個引數清單的指標輸出格式化的字串。這些函式已有更安全的版本可用，請參閱 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 。請注意偵測到無效的格式字串和錯誤的結果。