printf jefunkce vprogramovacím jazyce C, která provádíformátovanývýpisdat vtextové podobě.

Funkce má proměnný počet parametrů a nastandardní výstup vypíšetextový řetězec zadaný prvnímparametrem, v němž jsou formátovací direktivy nahrazeny hodnotami dalších parametrů. Použitý způsob formátování byl převzat do mnoha dalšíchprogramovacích jazyků a některéunixové shelly obsahují stejně pojmenovaný příkaz pro formátovaný výpis dat.

printf("Dnes je %s %d. %s %d; teplota je %+.1f stupňů Celsia.\n",dny_v_tydnu[dt],den,mesice[mesic],rok,teplota);

může vypsat

Dnes je středa 11. července 2018; teplota je +20.5 stupňů Celsia.

s odřádkováním na konci.

Vestandardní knihovně jazyka C je několik podobných funkcí deklarovaných vhlavičkovém souborustdio.h:

• printf – pro formátovaný výpis nastandardní výstup
• fprintf – pro formátovaný výstup do libovolnéhosouboru, resp.datového proudu otevřeného pro výstup
• sprintf – ukládá výstup dořetězce
• snprintf – ukládá výstup do řetězce omezené délky

Dále existují varianty pro výstup řetězců v kódováníUTF-32 složených ze znakůwide char (typuwchar_t); tyto funkce mají ve jméněwprintf místoprintf, a funkce deklarované vhlavičkovém souborustdarg.h, jimž se volitelné parametry předávají pomocí strukturyva_list, jejichž jména začínají písmenemv – například funkcevswprintf ukládá výstup zadaný strukturouva_list a formátovacím řetězcem typuwchar_t * a do řetězce téhož typu omezené délky (varianty prowide char pracují vždy s řetězci omezené délky a jejich jména místosn obsahují pouzesw).

Všechny uvedené funkce vracejí počet zapsaných znaků nebo zápornou hodnotu v případě chyby.

Podobnou filozofii mají funkce řadyscanf, které provádějí naopak vstupní konverzi.

Jedním z parametrů všech uvedených funkcí je formátovací řetězec, který může obsahovatsekvence pro výpis řídicích znaků začínající znakem zpětné lomítko (\) a formátovací direktivy začínající znakem procento (%).

Syntaxe formátovacích direktiv je následující:

%[číslo parametru][příznaky][šířka][.přesnost][velikost]typ

Jako typ lze použít některý z níže uvedených znaků:

Typ	Parametr	Význam
%	(žádný)	vypíše znak%
d,i	celočíselný	vypíše číslo vdesítkové soustavě se znaménkem
u	celočíselný	vypíše číslo vdesítkové soustavě bez znaménka
f,F	double	vypíše číslo ve formátu s pohyblivou řádovou tečkou; malé a velkéf se liší pouze ve způsobu výpisu nekonečna a chybného čísla (prof se vypisujeinf,infinity anan; proFINF,INFINITY aNAN)
e,E	double	vypíše hodnotu v semilogaritmickém tvaru ([-]d.ddde[+/-]ddd); podle použitého písmena budeE ve výpisu malé nebo velké; exponent má vždy nejméně dvě číslice; pro nulu je exponent00; ve Windows má exponent implicitně tři číslice, tj.1.5e002, lze změnit funkcí_set_output_format dostupnou v systémech Microsoftu
g,G	double	vypíše hodnotu jako kratší z řetězců získaných formátyf,F neboe,E; na rozdíl od celočíselných formátů se nevypisují nevýznamné nuly
x,X	celočíselný	vypíše číslo všestnáctkové soustavě bez znaménka, číslice 10 až 15 se pro typx vypisují malými písmenya,b,c,d,e,f, pro typX velkými písmenyA,B,C,D,E,F
o	celočíselný	vypíše číslo vosmičkové soustavě bez znaménka
s	char *	vypíše řetězec
c	char	vypíše znak
p	void *	vypíše adresu
a,A	double	vypíše obsah bytů v šestnáctkovém zápise začínajícím0x nebo0X[1][2] (v C++11 iostreams funguje stejněhexfloat).
n	ukazatel naint	Nic nevypisuje, ale do příslušného parametru uloží počet dosud vypsaných znaků (v rámci tohoto vyvoláníprintf Java: indikuje platformně neutrální znak konce řádku[3] Poznámka: tento parametr může být zneužit při útocíchUncontrolled format string

Pole velikost udává přesný typ příslušného parametru:

Velikost	Význam
hh	Pro celočíselný formát je použit parametr typuchar.
h	Pro celočíselný formát je použit parametr typushort.
l	Pro celočíselný formát je použit parametr typulong. Pro formát s pohyblivou řádovou čárkou nemá žádný efekt.[4]
ll	Pro celočíselný formát je použit parametr typulong long.
L	Pro formát s pohyblivou řádovou čárkou je použit parametr typulong double.
z	Pro celočíselný formát je použit parametr typusize_t.
j	Pro celočíselný formát je použit parametr typuintmax_t.
t	Pro celočíselný formát je použit parametr typuptrdiff_t.

Např.:printf("%ld", (long int) 1234567)

U formátů s pohyblivou řádovou čárkou udává, na kolik desetinných míst má být výpis čísla zaokrouhlen; u řetězců udává maximální počet znaků, které mají být vypsány.

Pole může být vynecháno, může být zadáno číslem, nebo hvězdičkou; hvězdička znamená, že hodnota je zadána parametrem typuint.
Např.printf("%.*s", 3, "abcdef") vypíšeabc

Šířka udáváminimální počet znaků, které mají být vypsány; pokud by byl výstup kratší bude doplněn mezerami (přesný způsob závisí na použitých příznacích). Pole šířka nikdy nezpůsobí zkrácení výpisu.

Zadání šířky může být vynecháno, může být použito číslo, nebo hvězdička; hvězdička znamená, že hodnotu udává další parametr typuint
Např.printf("%0*d", 5, 10) vypíše00010.

Je možné použít žádný, jeden nebo více příznaků v libovolném pořadí:

Příznak	Význam
- (minus)	zarovnat vlevo, vpravo doplnit mezerami
+ (plus)	před číslem vždy vypsat znaménko (i plus)
(mezera)	před záporným číslem vypsat -, před kladným mezeru
# (hash)	použít alternativní formát výpisu: pro typo vypisovat před nenulové číslo0 pro typx vypisovat před číslo0x pro typX vypisovat před číslo0X pro typye,E,f aF vždy psát desetinnou tečku pro typyg aG vždy psát tečku, neusekávat koncové nuly
0 (nula)	Pokud je použito pro numerický typ a je zadána šířka, doplní číslo na zadanou šířku zleva nulami; zatímcoprintf("%2X",3) vypíše 3, takprintf("%02X",3) vypíše03.

Číslo parametru je rozšířeníPOSIX, které není obsaženo v norměC99. Používá se například při lokalizaci softwaru, když je potřeba změnit pořadí slov zadaných jako parametry. Pokud je číslo parametru použito v jedné formátovací direktivě, musí být použito u všech v daném volání printf. Jeho tvar je:

Hodnota	Význam
n$	n je číslo parametru, který má být vypsán touto formátovací direktivou; opakováním téhož čísla je možné vypsat jeden parametr vícekrát i s použitím různých formátů Např.printf("%2$d (%2$x hex); %1$d (%1$x hex)",16,17) vypíše17 (11 hex); 16 (10 hex).

V tomto článku byl použitpřeklad textu z článkuprintf format string na anglické Wikipedii.

• Programování

• Monitoring:Články přeložené z enwiki