_printf_p, _printf_p_l, _wprintf_p, _wprintf_p_l

Článek
07/29/2015

Vytiskne formátovaný výstup do standardního výstupního datového proudu a umožní určení pořadí, ve kterém jsou parametry použity ve formátovacím řetězci.

int _printf_p(
   const char *format [,
   argument]... 
);
int _printf_p_l(
   const char *format,
   locale_t locale [,
   argument]... 
);
int _wprintf_p(
   const wchar_t *format [,
   argument]... 
);
int _wprintf_p_l(
   const wchar_t *format,
   locale_t locale [,
   argument]... 
);

Parametry

format
Ovládání formátu.
argument
Volitelné argumenty.
locale
Použité národní prostředí.

Vrácená hodnota

Vrátí počet vytištěných znaků nebo v případě chyby zápornou hodnotu.

Poznámky

Funkce _printf_p formátuje a vytiskne řadu znaků a hodnot do standardního výstupního proudu stdout.Pokud argumenty jsou podle řetězce format, řetězec format musí obsahovat specifikace, které určují výstupní formát pro argumenty (viz printf_p – poziční parametry).

Rozdíl mezi _printf_p a printf_s je ten, že _printf_p podporuje poziční parametry, které umožňují určit pořadí, ve kterém jsou argumenty použity ve formátovacím řetězci.Další informace naleznete v tématu printf_p – poziční parametry.

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

Pokud format nebo argument jsou NULL, nebo pokud řetězec formátu obsahuje neplatné formátovací znaky, funkce _printf_p a _wprintf_p vyvolá obslužnou rutinu neplatného parametru, jak je popsáno v Ověření parametru.Pokud provádění může pokračovat, funkce vrátí 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
_tprintf_p	_printf_p	_printf_p	_wprintf_p
_tprintf_p_l	_printf_p_l	_printf_p_l	_wprintf_p_l

Požadavky

Rutina	Požadované záhlaví
_printf_p, _printf_p_l	<stdio.h>
_wprintf_p, _wprintf_p_l	<stdio.h> nebo <wchar.h>

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.

Příklad

// crt_printf_p.c
// This program uses the _printf_p and _wprintf_p
// functions to choose the order in which parameters
// are used.

#include <stdio.h>

int main( void )
{
   // Positional arguments 
   _printf_p( "Specifying the order: %2$s %3$s %1$s %4$s %5$s.\n",
              "little", "I'm", "a", "tea", "pot");

   // Resume arguments
   _wprintf_p( L"Reusing arguments: %1$d %1$d %1$d %1$d\n", 10);

   // Width argument
   _printf_p("Width specifiers: %1$*2$s", "Hello\n", 10);
}