_vscprintf、 _vscprintf_l、 _vscwprintf、 _vscwprintf_l

發行項
02/28/2013

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

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是空值的指標，不正確的參數處理常式會叫用，如所述參數驗證。若要繼續，允許執行，函數會傳回-1，並設定errno到EINVAL。

備註

每個argument (如果有的話) 會轉換成對應的格式規格，以根據format。一般字元所組成的格式，與具有相同的表單，並作為format引數的 printf。

安全性提示
請確定，如果format是一個使用者定義的字串，它是 null 終止，並且具有正確的數目和參數型別。如需詳細資訊，請參閱避免緩衝區滿溢，。