vprintf_s, _vprintf_s_l, vwprintf_s, _vwprintf_s_l

Článek
03/26/2013

Zápis formátovaný výstup pomocí ukazatel na seznam argumentů.Jedná se o verze vprintf, _vprintf_l, vwprintf, _vwprintf_l s vylepšení zabezpečení, jak je popsáno v Funkce zabezpečení v CRT.

int vprintf_s(
   const char *format,
   va_list argptr 
);
int _vprintf_s_l(
   const char *format,
   locale_t locale,
   va_list argptr 
);
int vwprintf_s(
   const wchar_t *format,
   va_list argptr 
);
int _vwprintf_s_l(
   const wchar_t *format,
   locale_t locale,
   va_list argptr 
);

Parametry

format
Specifikace formátu.
argptr
Ukazatel na seznam argumentů.
locale
Národní prostředí pro použití.

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

Vrácená hodnota

vprintf_sa vwprintf_s vrácení počtu znaků zapsány, nikoli včetně ukončující znak null nebo zápornou hodnotu, pokud dojde k chybě výstup.Pokud format je ukazatel s hodnotou null nebo pokud formátovací řetězec obsahuje neplatný formátovací znaky, je vyvolána obslužná rutina neplatný parametr, jak je popsáno v Ověření parametrů.Pokud je povoleno spuštění pokračovat, funkce vrátí -1 a errno na EINVAL.

Informace o těchto a dalších kódů chyb naleznete v tématu _doserrno, kód chyby, _sys_errlist a _sys_nerr.

Poznámky

Každá z těchto funkcí bere ukazatel na seznam argumentů, pak formáty a zapíše poskytnutá data na stdout.

Bezpečné verze tyto funkce se liší od vprintf a vwprintf pouze v tom, že verze zkontrolujte, zda formátovací řetězec obsahuje neplatný formátovací znaky.

vwprintf_sje verzí širokého znaku vprintf_s; dvě funkce chovaly stejně jako v případě, že datový proud je otevřen v režimu ANSI.vprintf_snepodporuje aktuálně výstup do proudu UNICODE.

Verze těchto funkcí se _l přípony jsou shodné s tím rozdílem, že používají parametr locale předaný namísto aktuální národní prostředí pro vlákno.

Poznámka k zabezpečení
Zajistit, aby format není uživatelem definovaný řetězec.Další informace naleznete v tématu Zamezení způsobí přetečení vyrovnávací paměti.

Mapování rutiny obecného textu

TCHAR.Byla zahájena rutina h	_UNICODE & _MBCS není definováno	_MBCS, definice	_UNICODE definována
_vtprintf_s	vprintf_s	vprintf_s	vwprintf_s
_vtprintf_s_l	_vprintf_s_l	_vprintf_s_l	_vwprintf_s_l

Požadavky

Byla zahájena rutina	Požadované záhlaví	Volitelné záhlaví
vprintf_s, _vprintf_s_l	<stdio.h> a <stdarg.h>	<varargs.h> *
vwprintf_s, _vwprintf_s_l	<stdio.h> nebo <wchar.h> a <stdarg.h>	<varargs.h> *

* Vyžadována z důvodu kompatibility V systému UNIX.

V konzole není podporována v Windows Store apps.Úchyty standardní datový proud přidružené konzoly, stdin, stdout, a stderr, musí být přesměrována před C run-time funkce lze využít v Windows Store apps.Další informace o kompatibilitě, viz Compatibility v úvodu.