_vcprintf_p, _vcprintf_p_l, _vcwprintf_p, _vcwprintf_p_l

Článek
03/26/2013

Zapíše formátovaný výstup do konzoly pomocí ukazatel na seznam argumentů a podporuje poziční parametry ve formátovacím řetězci.

Důležité
Toto rozhraní API nelze použít v aplikacích, které jsou spuštěny v Windows Runtime.Další informace naleznete v tématu CRT funkce nejsou podporovány s /ZW.

int _vcprintf_p(
   const char* format,
   va_list argptr
);
int _vcprintf_p_l(
   const char* format,
   locale_t locale,
   va_list argptr
);
int _vcwprintf_p(
   const wchar_t* format,
   va_list argptr
);
int _vcwprintf_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 Syntaxe specifikace formátu: funkce printf a wprintf.

Vrácená hodnota

Počet znaků, které jsou napsány nebo zápornou hodnotu, pokud dojde k chybě výstup.Pokud format je ukazatel s hodnotou null, je vyvolána obslužná rutina neplatný parametr, jak je popsáno v Ověření parametrů.Je-li pokračovat, je povoleno zpracování errno je nastavena na EINVAL a vrátí hodnotu -1.

Poznámky

Každá z těchto funkcí bere ukazatel na seznam argumentů a potom použije _putch funkce formátování a zapsat poskytnutá data do konzoly.(_vcwprintf_p uses _putwch instead of _putch._vcwprintf_pje verzí širokého znaku _vcprintf_p.Trvá řetězce širokého znaku jako argument.)

Verze těchto funkcí, které mají _l přípony jsou shodné s tím rozdílem, že používají parametr locale, který je předán v namísto aktuální národní prostředí.

Každý argument (je-li k dispozici) bude převedena a je výstup podle odpovídajícího specifikaci formátu v format.Specifikace formátu podporuje poziční parametry, takže můžete určit pořadí, ve kterém jsou použity argumenty ve formátovacím řetězci.Další informace naleznete v tématu printf_p poziční parametry.

Tyto funkce není způsobovaly line feed znaky carriage return-line feed (CR-LF) kombinace při výstupu.

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.

Tyto funkce ověřit vstupní ukazatele a formátovací řetězec.Pokud format nebo argument je NULL, nebo pokud formátovací řetězec obsahuje neplatný formátovací znaky, tyto funkce vyvolat obslužnou rutinu neplatný parametr, jak je popsáno v Ověření parametrů.Pokud je povoleno spuštění pokračovat, vrátí tyto funkce hodnotu -1 a errno na EINVAL.

Mapování rutiny obecného textu

Byla zahájena rutina Tchar.h	_UNICODE a _MBCS není definováno	_MBCS, definice	_UNICODE definována
_vtcprintf_p	_vcprintf_p	_vcprintf_p	_vcwprintf_p
_vtcprintf_p_l	_vcprintf_p_l	_vcprintf_p_l	_vcwprintf_p_l

Požadavky

Byla zahájena rutina	Požadované záhlaví
_vcprintf_p, _vcprintf_p_l	<conio.h> a <stdarg.h>
_vcwprintf_p, _vcwprintf_p_l	<conio.h> a <stdarg.h>

Další informace o kompatibilitě v tématu Kompatibilita.

Příklad

// crt_vcprintf_p.c
// compile with: /c
#include <conio.h>
#include <stdarg.h>

// An error formatting function that's used to print to the console.
int eprintf(const char* format, ...)
{
  va_list args;
  va_start(args, format);
  return _vcprintf_p(format, args);
}

int main()
{
   int n = eprintf("parameter 2 = %2$d; parameter 1 = %1$s\r\n",
      "one", 222);
   _cprintf_s("%d characters printed\r\n");
}

Viz také

Referenční dokumentace

I/O konzoly a Port

_cprintf, _cprintf_l, _cwprintf, _cwprintf_l

va_arg, va_end, va_start

printf_p poziční parametry

Sdílet prostřednictvím