_vscprintf_p, _vscprintf_p_l, _vscwprintf_p, _vscwprintf_p_l

Artykuł
06/09/2015

Zwraca liczbę znaków w ciągu sformatowany za pomocą wskaźnika do listy argumentów, z możliwością, aby określić kolejność, w której używane są argumenty.

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 
);

Parametry

format
Ciąg formatu formantu.
argptr
Wskaźnik do listy argumentów.
locale
Ustawienia regionalne, aby użyć.

Aby uzyskać więcej informacji, zobacz Specyfikacji formatu.

Wartość zwracana

_vscprintf_pZwraca liczbę znaków, które byłyby wygenerowane Jeśli ciąg wskazywanego przez listę argumentów został wydrukowany lub wysyłane do pliku lub przy użyciu określonych kodów formatowania buforu.Wartość zwracana nie obejmuje kończącego znaku null._vscwprintf_ppełni tę samą funkcję, dla szerokości znaków.

Uwagi

Funkcje te różnią się od _vscprintf i _vscwprintf tylko w tym obsługują one możliwość określenia kolejności, w której używane są argumenty.Aby uzyskać więcej informacji, zobacz printf_p Parametry pozycyjne.

Wersje te funkcje, z _l sufiks są identyczne, z wyjątkiem, że używają oni przekazany zamiast bieżące ustawienia regionalne wątku parametr ustawień regionalnych.

Jeśli format jest wskaźnik zerowy, wywoływana jest funkcja obsługi nieprawidłowy parametr, jak opisano w Sprawdzanie poprawności parametru.Jeśli wykonanie może kontynuować, funkcje zwracają wartość -1 i errno do EINVAL.

Uwaga dotycząca zabezpieczeń
Zapewnienia, że jeśli format jest ciągiem zdefiniowane przez użytkownika jest zakończona znakiem null i ma poprawną liczbę i typ parametrów.Aby uzyskać więcej informacji, zobacz Overruns buforu unikanie.