Retorna uma string produzida de acordo com a string de formatação 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 prenchimento opcional que diz qual caractere será usado para prencher o resultado para o tamanho certo. Isto pode ser um espaço ou 0 (zero character). O padrão é prencher com espaços. Um caractere alternativo de prenchimento pode ser especificado colocando uma aspa simples (') antes. 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 é alinhar a direita; um caractere - fará com que seja alinhado a esquerda.
Um número opcional, um especificador de tamanho que diz quantos caracteres (mínimo) deve resultar desta conversão.
Um especificador de precisão opcional que diz quantos digitos decimais devem ser mostrados para números de ponto flutuante. Esta opção não tem efeito para outros tipos que não sejam float. (Outra função útil para formatar números é number_format().)
Um especificador de tipo que diz que o argumento deve ser tratado como do tipo. Os tipos possivéis são:
% - Um caractere porcento. Não é requerido neenhum argumento. |
b - O argumento é tratado com um inteiro, e mostrado como um binário. |
c - O argumento é tratado como um inteiro, e mostrado como o caractere ASCII correspondente. |
d - O argumento é tratado como um inteiro, e mostrado como um número decimal com sinal. |
u - O argumento é tratado com um inteiro, e mostrado como um número decimal sem sinal. |
f - O argumento é tratado como um float, e mostrado como um número de ponto flutuante. |
o - O argumento é tratado com um inteiro, e mostrado como un 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 as letras minúsculas). |
X - O argumento é tratado como um inteiro, e mostrado como um número hexadecimal (com as letras maiúsculas). |
Apartir do PHP 4.0.6 a string de formatação suporta numeração/troca. Aqui esta um exemplo:
Veja também printf(), sscanf(), fscanf(), vsprintf() e number_format().