_vprintf_p、 _vprintf_p_l、 _vwprintf_p、 _vwprintf_p_l

將格式化輸出利用指標寫入至參數清單,並能指定參數使用的順序。

int _vprintf_p(
   const char *format,
   va_list argptr 
);
int _vprintf_p_l(
   const char *format,
   locale_t locale,
   va_list argptr 
);
int _vwprintf_p(
   const wchar_t *format,
   va_list argptr 
);
int _vwprintf_p_l(
   const wchar_t *format,
   locale_t locale,
   va_list argptr 
);

參數

  • format
    格式規範。

  • argptr
    參數清單的指標。

  • locale
    使用的地區設定。

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

傳回值

_vprintf_p 和 _vwprintf_p 回傳寫入的字元數,不包含結尾的空字元,或者在輸出發生錯誤時回傳一個負值。

備註

這些函式都接受指標引數清單,然後格式和寫入 stdout的特定資料。這些函式與 vprintf_s 和 vwprintf_s 只不同它們支援指定引數的命令。如需詳細資訊,請參閱printf_p 位置參數

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

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

安全性注意事項安全性提示

須確保 format 不是使用者定義的字串。如需詳細資訊,請參閱 Avoiding Buffer Overruns

如果 format 為 null 指標,則為,如果格式字串包含無效的格式化字元,無效的參數叫用處理常式,如 參數驗證中所述。如果允許繼續執行,函式回傳 -1 並將 errno 設置為 EINVAL 。

泛用文字常式對應

TCHAR.H 常式

未定義 _UNICODE & _MBCS

已定義 _MBCS

已定義 _UNICODE

_vtprintf_p

_vprintf_p

_vprintf_p

_vwprintf_p

_vtprintf_p_l

_vprintf_p_l

_vprintf_p_l

_vwprintf_p_l

需求

程序

必要的標頭檔

選擇性的標頭檔

_vprintf_p, _vprintf_p_l

<stdio.h> 和 <stdarg.h>

<varargs.h>*

_vwprintf_p, _vwprintf_p_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_p、 _fprintf_p_l、 _fwprintf_p、 _fwprintf_p_l

_printf_p、 _printf_p_l、 _wprintf_p、 _wprintf_p_l

_sprintf_p、 _sprintf_p_l、 _swprintf_p、 _swprintf_p_l

vsprintf_s、 _vsprintf_s_l、 vswprintf_s、 _vswprintf_s_l

va_arg,va_end va_start

_vfprintf_p、 _vfprintf_p_l、 _vfwprintf_p、 _vfwprintf_p_l

_printf_p、 _printf_p_l、 _wprintf_p、 _wprintf_p_l

printf_p 位置參數