Função PHP vsprintf()
Exemplo
Escreva uma string formatada em uma variável:
<?php
$number = 9;
$str = "Beijing";
$txt = vsprintf("There are %u million bicycles in %s.",array($number,$str));
echo $txt;
?>
Definição e uso
A função vsprintf() grava uma string formatada em uma variável.
Ao contrário de sprintf(), os argumentos em vsprintf() são colocados em um array. Os elementos do array serão inseridos nos sinais de porcentagem (%) na string principal. Esta função funciona "passo a passo". No primeiro sinal %, o primeiro elemento do array é inserido, no segundo sinal %, o segundo elemento do array é inserido, etc.
Nota: Se houver mais sinais de % do que argumentos, você deve usar espaços reservados. Um espaço reservado é inserido após o sinal % e consiste no número do argumento e "\$". Veja o exemplo dois.
Dica: Funções relacionadas: fprintf() , vfprintf() , printf() , sprintf() e vprintf() .
Sintaxe
vsprintf(format,argarray)
Valores de parâmetro
Parameter | Description |
---|---|
format | Required. Specifies the string and how to format the variables in it. Possible format values:
Additional format values. These are placed between the % and the letter (example %.2f):
Note: If multiple additional format values are used, they must be in the same order as above. |
argarray | Required. An array with arguments to be inserted at the % signs in the format string |
Detalhes técnicos
Valor de retorno: | Retorna valores de matriz como uma string formatada |
---|---|
Versão do PHP: | 4.1.0+ |
Mais exemplos
Exemplo
Usando o valor de formato %f:
<?php
$num1 = 123;
$num2 = 456;
$txt = vsprintf("%f%f",array($num1,$num2));
echo $txt;
?>
Exemplo
Uso de marcadores de posição:
<?php
$number = 123;
$txt = vsprintf("With 2 decimals: %1\$.2f
<br>With no decimals: %1\$u",array($number));
echo $txt;
?>
Exemplo
Usando sprintf() para demonstrar todos os valores de formato possíveis:
<?php
$num1 = 123456789;
$num2 = -123456789;
$char = 50; // The ASCII Character 50 is 2
// Note: The format value "%%" returns a percent sign
echo sprintf("%%b = %b",$num1)."<br>"; // Binary number
echo sprintf("%%c = %c",$char)."<br>"; // The ASCII Character
echo sprintf("%%d = %d",$num1)."<br>"; // Signed decimal number
echo sprintf("%%d = %d",$num2)."<br>"; // Signed decimal number
echo sprintf("%%e = %e",$num1)."<br>"; // Scientific notation (lowercase)
echo sprintf("%%E = %E",$num1)."<br>"; // Scientific notation (uppercase)
echo sprintf("%%u = %u",$num1)."<br>"; // Unsigned decimal number (positive)
echo sprintf("%%u = %u",$num2)."<br>"; // Unsigned decimal number (negative)
echo sprintf("%%f = %f",$num1)."<br>"; // Floating-point number (local settings aware)
echo sprintf("%%F = %F",$num1)."<br>"; // Floating-point number (not local sett aware)
echo sprintf("%%g = %g",$num1)."<br>"; // Shorter of %e and %f
echo sprintf("%%G = %G",$num1)."<br>"; // Shorter of %E and %f
echo sprintf("%%o = %o",$num1)."<br>"; // Octal number
echo sprintf("%%s = %s",$num1)."<br>"; // String
echo sprintf("%%x = %x",$num1)."<br>"; // Hexadecimal number (lowercase)
echo sprintf("%%X = %X",$num1)."<br>"; // Hexadecimal number (uppercase)
echo sprintf("%%+d = %+d",$num1)."<br>"; // Sign specifier (positive)
echo sprintf("%%+d = %+d",$num2)."<br>"; // Sign specifier (negative)
?>
Exemplo
Uma demonstração de especificadores de string:
<?php
$str1 = "Hello";
$str2 = "Hello world!";
echo vsprintf("[%s]",array($str1))."<br>";
echo vsprintf("[%8s]",array($str1))."<br>";
echo vsprintf("[%-8s]",array($str1))."<br>";
echo vsprintf("[%08s]",array($str1))."<br>";
echo vsprintf("[%'*8s]",array($str1))."<br>";
echo vsprintf("[%8.8s]",array($str2))."<br>";
?>
❮ Referência de String PHP