_vprintf_p, _vprintf_p_l, _vwprintf_p, _vwprintf_p_l

Článek
06/09/2015

Zapíše formátovaný výstup pomocí ukazatele na seznam argumentů a povolí určení pořadí, ve kterém jsou argumenty použity.

int _vprintf_p(
   const char *format,
   va_list argptr 
);
int _vprintf_p_l(
   const char *format,
   locale_t locale,
   va_list argptr 
);
int _vwprintf_p(
   const wchar_t *format,
   va_list argptr 
);
int _vwprintf_p_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_pa _vwprintf_p vrátí počet napsaných znaků, bez ukončujícího znaku null, nebo zápornou hodnotu, dojde-li k chybě výstupu.

Poznámky

Každá z těchto funkcí bere ukazatel na seznam argumentů a potom formátuje a a zapisuje poskytnutá data do stdout.Tyto funkce se liší od vprintf_s a vwprintf_s pouze v tom, že podporují možnost určit pořadí, ve kterém jsou použity argumenty.Další informace naleznete v tématu printf_p – poziční parametry.

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

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.

Rutinní mapování obecného textu

Rutina TCHAR.H	_UNICODE & _MBCS není definováno	_MBCS definováno	_UNICODE definováno
_vtprintf_p	_vprintf_p	_vprintf_p	_vwprintf_p
_vtprintf_p_l	_vprintf_p_l	_vprintf_p_l	_vwprintf_p_l

Požadavky

Rutina	Požadované záhlaví	Volitelná záhlaví
_vprintf_p, _vprintf_p_l	<stdio.h> a <stdarg.h>	<varargs.h>*
_vwprintf_p, _vwprintf_p_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.