PHP - printf

Třída

Metoda - printf

(PHP 4, PHP 5, PHP 7)

Funkce printf() zformátuje vstup a ihned ho vypíše.

Při formátování vstupu pro určitou délku nesmíme zapomenout, že speciální znaky se nepočítají pouze jako jeden znak. To platí též pro výstup.

Procedurální

function printf (string $format, mixed $args, mixed $...) : int

Parametry

Název	Datový typ	Popis
$format	string	Formát textu. Vybrané značky popsané níže poté zastupují proměnné, které musí být předané v přesně uvedeném pořadí po znaku procenta (%). Volitelný parametr. Jedná se o znak znaménka (- nebo +), který určuje, zda-li musí mít číslo před sebou znaménko. Výchozí je -, což znamená, že pouze záporná čísla se označují. Pokud se předá +, čísla budou mít vždy + nebo - před sebou. Volitelný znak, který se použije v případě na vyplnění mezery, pokud není daný text dostatečně dlouhý. Může se jednat o mezeru nebo 0. Lze použít i jiný znak, musí však být před ním uveden apostrof ('). Pomlčka (-), po jejímž přidání se mezery do kratšího řetězce budou přidávat napravo (výchozí je nalevo). Volitelné číslo udávající minimální délku řetězce. Volitelný parametr s číslem uvedeném za tečkou (.), které uvádí, kolik desetinných míst má mít dané číslo (buď se ořízne, nebo se přidají nuly). Lze též použít pro řetězce, kde se poté uvádí jeho maximální délka. Povinný parametr uvádějící typové chování dané hodnoty. Možné typy: % - procento. Není potřeba žádný argument. b - převede celé číslo na binární číslo. c - převede celé číslo na znak ASCII. d - celé číslo. e - hodnota je prezentována vědeckým zápisem (např. 1.2e+2). E - stejné jako %e akorát používá velké písmeno (např. 1.2E+2). f - desetinné číslo (bere v potaz nastavení lokality). F - desetinné číslo (nebere v potaz nastavení lokality). g - kratší zápis %e a %f. G - kratší zápis %E a %f. o - převede celé číslo do osmičkové číselné soustavy. s - řetězec. u - převede celé číslo na kladné číslo. x - převede celé číslo do hexadecimální soustavy (malá písmena). X - převede celé číslo do hexadecimální soustavy (velká písmena).
$args	mixed	Argumenty zastupující proměnné v textu pro formát.
$...	mixed	Argumenty zastupující proměnné v textu pro formát.

Název

Datový typ

Výchozí hodnota

Popis

$format

string

Formát textu. Vybrané značky popsané níže poté zastupují proměnné, které musí být předané v přesně uvedeném pořadí po znaku procenta (%).

Volitelný parametr. Jedná se o znak znaménka (- nebo +), který určuje, zda-li musí mít číslo před sebou znaménko. Výchozí je -, což znamená, že pouze záporná čísla se označují. Pokud se předá +, čísla budou mít vždy + nebo - před sebou.
Volitelný znak, který se použije v případě na vyplnění mezery, pokud není daný text dostatečně dlouhý. Může se jednat o mezeru nebo 0. Lze použít i jiný znak, musí však být před ním uveden apostrof (').
Pomlčka (-), po jejímž přidání se mezery do kratšího řetězce budou přidávat napravo (výchozí je nalevo).
Volitelné číslo udávající minimální délku řetězce.
Volitelný parametr s číslem uvedeném za tečkou (.), které uvádí, kolik desetinných míst má mít dané číslo (buď se ořízne, nebo se přidají nuly). Lze též použít pro řetězce, kde se poté uvádí jeho maximální délka.
Povinný parametr uvádějící typové chování dané hodnoty. Možné typy:

% - procento. Není potřeba žádný argument.
b - převede celé číslo na binární číslo.
c - převede celé číslo na znak ASCII.
d - celé číslo.
e - hodnota je prezentována vědeckým zápisem (např. 1.2e+2).
E - stejné jako %e akorát používá velké písmeno (např. 1.2E+2).
f - desetinné číslo (bere v potaz nastavení lokality).
F - desetinné číslo (nebere v potaz nastavení lokality).
g - kratší zápis %e a %f.
G - kratší zápis %E a %f.
o - převede celé číslo do osmičkové číselné soustavy.
s - řetězec.
u - převede celé číslo na kladné číslo.
x - převede celé číslo do hexadecimální soustavy (malá písmena).
X - převede celé číslo do hexadecimální soustavy (velká písmena).

$args

mixed

Argumenty zastupující proměnné v textu pro formát.

$...

mixed

Argumenty zastupující proměnné v textu pro formát.

Návratové hodnoty

Vrací: int

Délka vypsaného textu.

Příklady

<?php
    printf("Ahoj %s!", "světe");

Lze také přidávat více parametrů, kdy se vkládají v určeném pořadí:

<?php
    printf("Leželo %s %d banánů", "tam", 5);

Pořadí lze také zaměnit:

<?php
    printf('Leželo %2$s %1$d banánů', 5, "tam");

Je též možné různě doplňovat čísla do dané délky vybraným znakem:

<?php
    printf("%'.9d", 534);
    echo ('<br />');
    printf("%09d", 534);

To také platí pro texty:

<?php
    echo ('<pre>');
    printf("[%15s]", 'Ahoj světe!');
    echo ('<br />');
    printf("[%015s]", 'Ahoj světe!');
    echo ('<br />');
    printf("[%-15s]", 'Ahoj světe!');
    echo ('<br />');
    printf("[%.15s]", 'Ahoj světe!');
    echo ('<br />');
    printf("[%.15s]", 'Ahoj nádherný světe!');

Související manuály

Aktivity

Nejčastěji vyhledáváné