_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 對等用法
請參閱
參考
_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
_vfprintf_p、 _vfprintf_p_l、 _vfwprintf_p、 _vfwprintf_p_l