vprintf, _vprintf_l, vwprintf, _vwprintf_l

Článek
06/09/2015

Zapíše formátovaný výstup pomocí ukazatele na seznam argumentů.Bezpečnější verze těchto funkcí jsou k dispozici; viz 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
Použité národní prostředí.

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

Vrácená hodnota

vprintfa vwprintf vrátí počet napsaných znaků, bez ukončujícího znaku null, nebo zápornou hodnotu, dojde-li k chybě výstupu.Pokud format je ukazatel s hodnotou null, nebo pokud řetězec formátu obsahuje neplatné formátovací znaky, je vyvolána obslužná rutina neplatného parametru, jak je popsáno v Ověření parametru.Pokud provádění může pokračovat, vrátí funkce hodnotu -1 a nastaví errno na EINVAL.

Informace o těchto a dalších chybových kódech naleznete v části _doserrno, errno, _sys_errlist, and _sys_nerr.

Poznámky

Každá z těchto funkcí bere ukazatel na seznam argumentů a potom formátuje a a zapisuje poskytnutá data do stdout.

vwprintf je širokoznaká verze vprintf; tyto dvě funkce se chovají stejně, pokud je datový proud otevřen v režimu ANSI.vprintf aktuálně nepodporuje výstup v proudu UNICODE.

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

Poznámka k zabezpečení
Zajistěte, aby format nebyl uživatelem definovaný řetězec.Další informace naleznete v tématu Předcházení 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.

Rutinní mapování obecného textu

Rutina TCHAR.H	_UNICODE & _MBCS není definováno	_MBCS definováno	_UNICODE definováno
_vtprintf	vprintf	vprintf	vwprintf
_vtprintf_l	_vprintf_l	_vprintf_l	_vwprintf_l

Požadavky

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>*

* Potřebné k zajištění kompatibility systému UNIX V.

Konzola není v aplikacích Windows Store podporována.Standardní datový proud popisovačů, které jsou spojeny s konzolou – stdin, stdout a stderr, musí být přesměrován před použitím funkcí jazyka C run-time je v aplikacích Windows Store.Další informace o kompatibilitě naleznete v tématu Kompatibilita.