Manual do PHP
Anterior |  | Próxima

# 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:

1. 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.

2. 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.

3. Um número opcional, um especificador de largura que diz quantos caracteres (mínimo) deve resultar desta conversão.

4. 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().)

5. 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

Exemplo 1. sprintf(): inteiros prenchidos com zero
`<?php $isodate = sprintf("%04d-%02d-%02d", $year, $month, $day); ?>`

Exemplo 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" ?>`

Anterior | Principal | Próxima
explode | Acima | get_html_translation_table