_vscprintf, _vscprintf_l, _vscwprintf, _vscwprintf_l

Článek
06/09/2015

Vrátí počet znaků v formátovaný řetězec pomocí ukazatele na seznam argumentů.

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
Řetězec formátu řízení.
argptr
Ukazatel na seznam argumentů.
locale
Národní prostředí použít.

Další informace naleznete v tématu Specifikace formátu.

Vrácená hodnota

_vscprintfVrátí počet znaků, které by generovány v případě, že řetězec označenou v seznamu argumentů byla vytištěna nebo odeslána do souboru nebo zadaný formátovací kódy pomocí vyrovnávací paměti.Vrácená hodnota nezahrnuje ukončujícím znakem null._vscwprintfmá stejnou funkci pro širokou znaky.

Verze těchto funkcí se _l přípony jsou shodné s výjimkou, že používají národní prostředí parametr předaný namísto aktuální podproces národní prostředí.

Pokud format je nulový ukazatel vyvolat neplatný parametr popisovače, jak je popsáno v Ověření parametru.Pokud je povoleno spuštění pokračovat, funkce vrátí -1 a errno na EINVAL.

Poznámky

Každý argument (pokud existuje) se převede podle odpovídající specifikaci formátu v format.Formát se skládá z běžných znaků a má stejný formulář a fungovat jako format argument pro printf.

Poznámka k zabezpečení
Zajistit, že pokud format je uživatelem definovaný řetězec je null ukončena a má správný počet a typ parametrů.Další informace naleznete v tématu Vyhnout způsobí přetečení vyrovnávací paměti.