fprintf
(PHP 5)
fprintf — Escreve uma string formatada para um stream
Descrição
int fprintf
( resource $handle
, string $format
[, mixed $args
] )
Escreve uma string produzida de acordo com a string de formato
format
para o recurso de stream especificado
por handle
..
A string de formato é composta por zero ou mais diretivas:
caracteres ordinários(excluindo %) que são copiados
diretamente para o resultado ,e especificações de
conversão, cada qual dos resultados obtidos do seu próprio parâmetro.
Isto se aplica para fprintf(),
sprintf(), e printf().
Cada especificação de conversão consite de um sinal de porcentagem
(%), seguido por um ou mais destes elementos, em ordem:
-
Um especificador de prenchimento opcional que diz
qual caractere será usado para prencher os resultados
para o tamanho certo da string. Este pode ser um caracteres de espaço ou um
0 (zero). O padrão é prencher com espaços.
Um caractere de prenchimento alternativo pode ser especificado
colocando-se antes um aspa simples (').
Veja os exemplos abaixo.
-
Um especificador de alinhamento opcional que diz
se o resultado deve ser alinhado a esquerda ou a direita.
O padrão é alinhado a direita; um caractere -
aqui fará ser alinhado a esquerda.
-
Um número opcional, um especificador de largura
que diz quantos caracteres (mínimo) deve resultar desta conversão.
-
Um especificador de precisão que diz
quantos digitos decimais serão mostrados para números de ponto flutuante.
Esta opção não tem efeito para outros tipos senão
float. (Outra função util para formatar números é
number_format().)
-
Um especificador de tipo que diz de qual tipo o argumento será tratado como.
Tipos possiveis são:
-
% - um caractere de porcentagem.
Não é necessário nenhum argumento.
-
b - o argumento é tratado como um inteiro
e mostrado como um número binário.
-
c - o argumento é tratado como um inteiro e
mostrado o caractere ASCII.
value.
-
d - o argumento é tratado como um inteiro e
mostrado como um número decimal com sinal.
-
u - o argumento é tratado como um inteiro e
mostrado como um número decimal sem sinal.
-
f - o argumento é tratado com um
float e mostrado como um número de ponto flutuante.
-
o - o argumento é tratado como um inteiro e
mostrado como um número octal.
-
s - O argumento é tratado e mostrado como
uma string.
-
x - o argumento é tratado como um inteiro e
mostrado como um número hexadecimal (com
letras minúsculas).
-
X - o argumento é tratado como um inteiro e
mostrado como um número hexadecimal (com
letras maiúsculas).
Veja também: printf(),
sprintf(),
sscanf(), fscanf(),
vsprintf(), e
number_format().
Examplos
Example#1 sprintf(): inteiros prenchidos com zero
<?php
$isodate = sprintf("%04d-%02d-%02d", $year, $month, $day);
?>
Example#2 sprintf(): formatando valores
<?php
$money1 = 68.75;
$money2 = 54.35;
$money = $money1 + $money2;
// echo $money irá mostrar "123.1";
$formatted = sprintf("%01.2f", $money);
// echo $formatted irá mostar "123.10"
?>