_vscprintf, _vscprintf_l, _vscwprintf, _vscwprintf_l

Artykuł
06/09/2015

Zwraca liczbę znaków w ciągu sformatowany za pomocą wskaźnika do listy argumentów.

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

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

_vscprintfZwraca 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._vscwprintfpełni tę samą funkcję, dla szerokości znaków.

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.

Uwagi

Każdy argument (jeśli ma zastosowanie) jest konwertowana zgodnie z odpowiednich specyfikacji formatu w format.Format składa się ze znaków zwykłych i ma ten sam formularz i działać jako format argument dla printf.

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.