_vprintf_p, _vprintf_p_l, _vwprintf_p, _vwprintf_p_l

Článek
03/26/2013

Zápis formátovaný výstup pomocí ukazatel na seznam argumentů, umožňuje určit pořadí, ve kterém jsou použity argumenty.

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
Národní prostředí pro použití.

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

Vrácená hodnota

_vprintf_pa _vwprintf_p 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.

Poznámky

Každá z těchto funkcí bere ukazatel na seznam argumentů, pak formáty a zapíše poskytnutá data na stdout.Tyto funkce se liší od vprintf_s a vwprintf_s pouze v tom, že podporuje 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_pje verzí širokého znaku _vprintf_p; dvě funkce chovaly stejně jako v případě, že datový proud je otevřen v režimu ANSI._vprintf_pnepodporuje 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.

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.

Mapování rutiny obecného textu

TCHAR.Byla zahájena rutina h	_UNICODE & _MBCS není definováno	_MBCS, definice	_UNICODE definována
_vtprintf_p	_vprintf_p	_vprintf_p	_vwprintf_p
_vtprintf_p_l	_vprintf_p_l	_vprintf_p_l	_vwprintf_p_l

Požadavky

Byla zahájena 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> *

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