_printf_p, _printf_p_l, , _wprintf_p_wprintf_p_l

Vytiskne formátovaný výstup do standardního výstupního datového proudu a povolí specifikaci pořadí, ve kterém se parametry používají v řetězci formátu.

Syntaxe

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
Formátovat ovládací prvek

argument
Volitelné argumenty

locale
Národní prostředí, které se má použít

Vrácená hodnota

Vrátí počet tištěných znaků nebo zápornou hodnotu, pokud dojde k chybě.

Poznámky

Funkce _printf_p formátuje a vytiskne řadu znaků a hodnot do standardního výstupního datového proudu. stdout Pokud argumenty následují za format řetězcem, format musí řetězec obsahovat specifikace určující výstupní formát argumentů (viz printf_p poziční parametry).

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

_wprintf_p je širokoznačná verze _printf_p; chovají se stejně, pokud je datový proud otevřen v režimu ANSI. _printf_p v současné době nepodporuje výstup do datového proudu UNICODE.

Verze těchto funkcí s příponou _l jsou shodné s tím rozdílem, že používají parametr národního prostředí předaný místo aktuálního národního prostředí vlákna.

Důležité

Ujistěte se, že format není uživatelem definovaný řetězec.

Pokud format nebo jsou NULLnebo argument formátovací řetězec obsahuje neplatné znaky formátování a _printf_p _wprintf_p funkce vyvolat neplatnou obslužnou rutinu parametru, jak je popsáno v ověření parametru. Pokud je spuštění povoleno pokračovat, vrátí funkce hodnotu -1 a nastaví errno hodnotu EINVAL.

Mapování rutin obecného textu

Rutina Tchar.h	_UNICODE a _MBCS není definován	_MBCS definovaný	_UNICODE definovaný
_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ý hlavičkový soubor
_printf_p, _printf_p_l	<stdio.h>
_wprintf_p, _wprintf_p_l	<stdio.h> nebo <wchar.h>

Konzola není podporována v aplikacích pro Univerzální platforma Windows (UPW). Standardní zpracování datových proudů, které jsou přidružené ke konzole , a , stderrmusí být přesměrovány před tím, stdinstdoutnež je funkce runtime jazyka C mohou používat v aplikacích pro UPW. Další informace o kompatibilitě najdete v tématu Kompatibilita.

Důležité

Počínaje Windows 10 verze 2004 (build 19041) printf vytiskne řada funkcí přesně reprezentovatelná čísla s plovoucí desetinnou čárkou podle pravidel IEEE 754 pro zaokrouhlování. V předchozích verzích Windows by se vždy zaokrouhlila přesně reprezentovatelná čísla s plovoucí desetinnou čárkou končící na 5. IEEE 754 uvádí, že musí zaokrouhlit na nejbližší sudou číslici (označované také jako "Zaokrouhlování bankera"). Například obě printf("%1.0f", 1.5) a printf("%1.0f", 2.5) měly by se zaokrouhlit na 2. Dříve by se 1,5 zaokrouhlo na 2 a 2,5 by se zaokrouhlilo na 3. Tato změna má vliv jenom na přesně reprezentovatelná čísla. Například hodnota 2,35 (která je při znázornění v paměti blíže 2,350000000000008) pokračuje zaokrouhlit nahoru na 2,4. Zaokrouhlování provedené těmito funkcemi nyní respektuje také režim zaokrouhlování s plovoucí desetinou čárkou nastavený .fesetround Dříve bylo zaokrouhlení vždy zvoleno FE_TONEAREST chování. Tato změna má vliv jenom na programy vytvořené pomocí sady Visual Studio 2019 verze 16.2 a novější. Chcete-li použít starší chování zaokrouhlování s plovoucí desetinou čárkou, propojte s legacy_stdio_float_rounding.obj.

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);
}

Specifying the order: I'm a little tea pot.
Reusing arguments: 10 10 10 10
Width specifiers:     Hello

Viz také

Podpora pro matematiku a plovoucí desetinou čárku
Vstupně-výstupní operace streamu
Národní prostředí
fopen, _wfopen
_fprintf_p, _fprintf_p_l, , _fwprintf_p_fwprintf_p_l
fprintf, _fprintf_l, , fwprintf_fwprintf_l
fprintf_s, _fprintf_s_l, , fwprintf_s_fwprintf_s_l
scanf, _scanf_l, , wscanf_wscanf_l
scanf_s, _scanf_s_l, , wscanf_s_wscanf_s_l
_sprintf_p, _sprintf_p_l, , _swprintf_p_swprintf_p_l
sprintf, _sprintf_l, swprintf, , _swprintf_l__swprintf_l
sprintf_s, _sprintf_s_l, , swprintf_s_swprintf_s_l
vprintf – funkce