_vscprintf、_vscprintf_l、_vscwprintf、_vscwprintf_l

發行項
06/09/2015

在格式化字串中使用指標引數清單傳回字元數。

int _vscprintf(
   const char *format,
   va_list argptr 
);
int _vscprintf_l(
   const char *format,
   locale_t locale,
   va_list argptr 
);
int _vscwprintf(
   const wchar_t *format,
   va_list argptr 
);
int _vscwprintf_l(
   const wchar_t *format,
   locale_t locale,
   va_list argptr 
);

參數

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

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

傳回值

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

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

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

備註

每個 argument (如果有的話) 是根據 format 中的對應格式規格進行轉換。此格式包含一般字元，與 printf 的 format 引數具有相同的形式和功能。

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