(PHP 4, PHP 5)
sprintf — Retorna a string formatada
Retorna uma string produzida de acordo com a string de formatação
format.
format
A string e formatação é composta de zero ou mais diretivas: caracteres normais (excluindo %) que são copiados diretamente para o resultado, e especificações de conversão, cada um dos quais resulta em obter o seu próprio parâmetro. Isto se aplica para sprintf() e printf().
Cada especificação de conversão consiste em um símbolo de porcento (%), seguido por um ou mais destes elementos em ordem:
Um especificador de tipo que diz que o argumento deve ser tratado como do tipo. Os tipos possivéis são:
A string de formato suporta argumentos com numeração/troca. Aqui está um exemplo:
Exemplo #1 Troca de argumentos
<?php
$format = 'There are %d monkeys in the %s';
printf($format,$num,$location);
?>
Exemplo #2 Troca de argumentos
<?php
$format = 'The %s contains %d monkeys';
printf($format,$num,$location);
?>
Exemplo #3 Troca de argumento
<?php
$format = 'The %2$s contains %1$d monkeys';
printf($format,$num,$location);
?>
Exemplo #4 Troca de argumento
<?php
$format = 'The %2$s contains %1$d monkeys.
That\'s a nice %2$s full of %1$d monkeys.';
printf($format, $num, $location);
?>
args
...
Retorna a string produzida de acordo com as strings de formatação
format.
| Versão | Descrição |
|---|---|
| 4.0.6 | Suporte para argumento numerado/troca foi adicionado |
Exemplo #5 printf(): vários exemplos
<?php
$n = 43951789;
$u = -43951789;
$c = 65; // ASCII 65 is 'A'
// notice the double %%, this prints a literal '%' character
printf("%%b = '%b'\n", $n); // binary representation
printf("%%c = '%c'\n", $c); // print the ascii character, same as chr() function
printf("%%d = '%d'\n", $n); // standard integer representation
printf("%%e = '%e'\n", $n); // scientific notation
printf("%%u = '%u'\n", $n); // unsigned integer representation of a positive integer
printf("%%u = '%u'\n", $u); // unsigned integer representation of a negative integer
printf("%%f = '%f'\n", $n); // floating point representation
printf("%%o = '%o'\n", $n); // octal representation
printf("%%s = '%s'\n", $n); // string representation
printf("%%x = '%x'\n", $n); // hexadecimal representation (lower-case)
printf("%%X = '%X'\n", $n); // hexadecimal representation (upper-case)
printf("%%+d = '%+d'\n", $n); // sign specifier on a positive integer
printf("%%+d = '%+d'\n", $u); // sign specifier on a negative integer
?>
O exemplo acima irá imprimir:
%b = '10100111101010011010101101' %c = 'A' %d = '43951789' %e = '4.39518e+7' %u = '43951789' %u = '4251015507' %f = '43951789.000000' %o = '247523255' %s = '43951789' %x = '29ea6ad' %X = '29EA6AD' %+d = '+43951789' %+d = '-43951789'
Exemplo #6 printf(): especificadores de string
<?php
$s = 'monkey';
$t = 'many monkeys';
printf("[%s]\n", $s); // standard string output
printf("[%10s]\n", $s); // right-justification with spaces
printf("[%-10s]\n", $s); // left-justification with spaces
printf("[%010s]\n", $s); // zero-padding works on strings too
printf("[%'#10s]\n", $s); // use the custom padding character '#'
printf("[%10.10s]\n", $t); // left-justification but with a cutoff of 10 characters
?>
O exemplo acima irá imprimir:
[monkey] [ monkey] [monkey ] [0000monkey] [####monkey] [many monke]
Exemplo #7 sprintf(): inteiros prenchidos com zero
<?php
$isodate = sprintf("%04d-%02d-%02d", $year, $month, $day);
?>
Exemplo #8 sprintf(): formatando dinheiro
<?php
$money1 = 68.75;
$money2 = 54.35;
$money = $money1 + $money2;
// echo $money irá mostrar "123.1";
$formatted = sprintf("%01.2f", $money);
// echo $formatted irá mostrar "123.10"
?>
Exemplo #9 sprintf(): notação científica
<?php
$number = 362525200;
echo sprintf("%.3e", $number); // imprime 3.625e+8
?>