Função sprintf

A função sprintf formata uma string de acordo com um padrão especificado e retorna o resultado. O primeiro parâmetro aceita uma string de formato, e os parâmetros subsequentes são os valores para substituição. Na string de formato, são usados caracteres especiais (especificadores de formato), que começam com o sinal % e controlam a formatação da saída.

Sintaxe

phpsprintf(format, arg1, arg2, ...);

Especificadores de formato

Especificador Descrição
%s String
%d Número inteiro com sinal (decimal)
%u Número inteiro sem sinal (decimal)
%f Número de ponto flutuante (dependente da localidade)
%F Número de ponto flutuante (não dependente da localidade)
%c Caractere por código ASCII
%x Número inteiro no sistema hexadecimal (minúsculas)
%X Número inteiro no sistema hexadecimal (maiúsculas)
%o Número inteiro no sistema octal
%b Número inteiro no sistema binário
%e Notação científica (minúsculas)
%E Notação científica (maiúsculas)
%g Formato curto de %e ou %f
%G Formato curto de %E ou %F
%% Sinal de percentagem

Exemplo

Formatação de string com substituição de número inteiro:

php<?php
  $res = sprintf("There are %d apples", 5);
  echo $res;
?>

Resultado da execução do código:

php'There are 5 apples'

Exemplo

Formatação com múltiplas substituições:

php<?php
  $res = sprintf("%s has %d points", "John", 120);
  echo $res;
?>

Resultado da execução do código:

php'John has 120 points'

Exemplo

Formatação de números de ponto flutuante:

php<?php
  $res = sprintf("Price: $%.2f", 12.356);
  echo $res;
?>

Resultado da execução do código:

php'Price: $12.36'

Veja também

  • a função printf,
    que exibe uma string formatada
  • a função vsprintf,
    que funciona de forma semelhante, mas aceita um array de argumentos