vprintf_s, _vprintf_s_l, vwprintf_s, _vwprintf_s_l

Článek
06/09/2015

Zapíše formátovaný výstup pomocí ukazatele na seznam argumentů.Tyto verze vprintf, _vprintf_l, vwprintf, _vwprintf_l mají rozšíření zabezpečení popsaná v tématu 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
Použité národní prostředí.

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

Vrácená hodnota

vprintf_sa vwprintf_s 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.

Bezpečné verze těchto funkce se liší od vprintf a vwprintf pouze v tom, že bezpečné verze kontrolují, zda formátovací řetězec obsahuje platné formátovací znaky.

vwprintf_s je širokoznaká verze vprintf_s; tyto dvě funkce se chovají stejně, pokud je datový proud otevřen v režimu ANSI.vprintf_s 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.

Rutinní mapování obecného textu

Rutina TCHAR.H	_UNICODE & _MBCS není definováno	_MBCS definováno	_UNICODE definováno
_vtprintf_s	vprintf_s	vprintf_s	vwprintf_s
_vtprintf_s_l	_vprintf_s_l	_vprintf_s_l	_vwprintf_s_l

Požadavky

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

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