_vcprintf_p, _vcprintf_p_l, _vcwprintf_p, _vcwprintf_p_l

Článek
06/09/2015

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

Důležité
Toto API nelze použít v aplikacích, které jsou spuštěny v prostředí 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
Použité národní prostředí.

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ého parametru, jak je popsáno v Ověření parametru.Pokud provádění může pokračovat, errno se nastaví na EINVAL a vrátí se -1.

Poznámky

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

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

Každý argument (pokud existuje) bude převedena a je výstup podle odpovídající 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 řádek krmiva (CR-LF) kombinace při výstupu.

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.

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í 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 a _MBCS nejsou definovány	_MBCS definováno	_UNICODE definováno
_vtcprintf_p	_vcprintf_p	_vcprintf_p	_vcwprintf_p
_vtcprintf_p_l	_vcprintf_p_l	_vcprintf_p_l	_vcwprintf_p_l

Požadavky

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ě naleznete 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 portu

_cprintf, _cprintf_l, _cwprintf, _cwprintf_l

va_arg, va_copy, va_end, va_start

printf_p – poziční parametry

Sdílet prostřednictvím