_vscprintf_p、_vscprintf_p_l、_vscwprintf_p、_vscwprintf_p_l

發行項
06/09/2015

傳回字元數在格式化字串中使用指標引數清單，且能夠指定引數的命令。

int _vscprintf_p(
   const char *format,
   va_list argptr 
);
int _vscprintf_p _l(
   const char *format,
   locale_t locale,
   va_list argptr 
);
int _vscwprintf_p (
   const wchar_t *format,
   va_list argptr 
);
int _vscwprintf_p _l(
   const wchar_t *format,
   locale_t locale,
   va_list argptr 
);

參數

format
格式控制字串。
argptr
參數清單的指標。
locale
要使用的地區設定。

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

傳回值

若由引數清單指向的字串列印或傳送至檔案或緩衝區，使用特定的格式化程式碼，而產生字元，_vscprintf_p 傳回字元數。傳回的值不包含結束的 null 字元。 _vscwprintf_p 實作寬字元的相同功能函式。

備註

這些函式與 _vscprintf 和 _vscwprintf 的不同在於它們只支援指定引數的命令。如需詳細資訊，請參閱printf_p 位置參數。

這些有 _l 尾碼的函式版本是一樣的，不同之處在於會使用傳入的地區設定，而不使用目前的執行緒地區設定。

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

安全性提示
請確定，如果 format 是使用者定義的字串，它是 NULL 結尾並具有正確的參數數目和型別。如需詳細資訊，請參閱 Avoiding Buffer Overruns 。