vprintf, _vprintf_l, vwprintf, _vwprintf_l

Článek
03/26/2013

Zápis formátovaný výstup pomocí ukazatel na seznam argumentů.Bezpečnější verze tyto funkce jsou k dispozici, naleznete v tématu vprintf_s, _vprintf_s_l, vwprintf_s, _vwprintf_s_l.

int vprintf(
   const char *format,
   va_list argptr 
);
int _vprintf_l(
   const char *format,
   locale_t locale,
   va_list argptr 
);
int vwprintf(
   const wchar_t *format,
   va_list argptr 
);
int _vwprintf_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

vprintfa vwprintf 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.

vwprintfje verzí širokého znaku vprintf; dvě funkce chovaly stejně jako v případě, že datový proud je otevřen v režimu ANSI.vprintfnepodporuje 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.Všimněte si, že neplatný formátovací řetězce jsou zjištěny a výsledkem je chyba.

Mapování rutiny obecného textu

TCHAR.Byla zahájena rutina h	_UNICODE & _MBCS není definováno	_MBCS, definice	_UNICODE definována
_vtprintf	vprintf	vprintf	vwprintf
_vtprintf_l	_vprintf_l	_vprintf_l	_vwprintf_l

Požadavky

Byla zahájena rutina	Požadované záhlaví	Volitelné záhlaví
vprintf, _vprintf_l	<stdio.h> a <stdarg.h>	<varargs.h> *
vwprintf, _vwprintf_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.