(PHP 4, PHP 5)
sprintf — Devuelve un string formateado
Devuelve un string producido de acuerdo con el string
format.
format
El string de formato está compuesto de cero o más directivas: caracteres ordinarios (excluyendo %) que son copiados directamente al resultado y especificaciones de conversión, cada una de las cuales da lugar a extraer su propio parámetro. Esto aplica tanto para sprintf() como printf().
Cada especificación de conversión consiste en un signo de porcentaje (%), seguido por uno o más de estos elementos, en orden:
Un especificador de tipo que indica como que tipo deben ser tratados los datos del argumento. Los tipos posibles son:
El string de formato soporta numeración/intercambio de argumentos. Aquí está un ejemplo:
Ejemplo #1 Intercambio de argumentos
<?php
$num = 5;
$location = 'tree';
$format = 'There are %d monkeys in the %s';
echo sprintf($format, $num, $location);
?>
Ejemplo #2 Intercambio de argumentos
<?php
$format = 'The %s contains %d monkeys';
echo sprintf($format, $num, $location);
?>
Ejemplo #3 Intercambio de argumentos
<?php
$format = 'The %2$s contains %1$d monkeys';
echo sprintf($format, $num, $location);
?>
Ejemplo #4 Intercambio de argumentos
<?php
$format = 'The %2$s contains %1$d monkeys.
That\'s a nice %2$s full of %1$d monkeys.';
echo sprintf($format, $num, $location);
?>
Ejemplo #5 Especificador de posición con otros especificadores
<?php
$format = 'The %2$s contains %1$04d monkeys';
echo sprintf($format, $num, $location);
?>
El resultado del ejemplo sería:
The tree contains 0005 monkeys
Nota:
Tratar de utilizar marcadores de posición mayores que
PHP_INT_MAXprovocará que sprintf() lance mensajes de advertencia.
args
...
Devuelve un string producido de acuerdo con el string de formato
format.
| Versión | Descripción |
|---|---|
| 4.0.6 | Fue agregado el soporte para numeración/intercambio de argumentos |
Ejemplo #6 printf(): ejemplos varios
<?php
$n = 43951789;
$u = -43951789;
$c = 65; // ASCII 65 es 'A'
// fijarse en el doble %%, esto muestra un caracter '%' literal
printf("%%b = '%b'\n", $n); // representación binaria
printf("%%c = '%c'\n", $c); // muestra el caracter ascii, igual que la función chr()
printf("%%d = '%d'\n", $n); // representación estándar de un entero
printf("%%e = '%e'\n", $n); // notación científica
printf("%%u = '%u'\n", $n); // representación sin signo de un entero positivo
printf("%%u = '%u'\n", $u); // representación sin signo de un entero negativo
printf("%%f = '%f'\n", $n); // representación de punto flotante
printf("%%o = '%o'\n", $n); // representación octal
printf("%%s = '%s'\n", $n); // representación en una cadena
printf("%%x = '%x'\n", $n); // representación hexadecimal (minúsculas)
printf("%%X = '%X'\n", $n); // representación hexadecimal (mayúsculas)
printf("%%+d = '%+d'\n", $n); // especificador de signo sobre un entero positivo
printf("%%+d = '%+d'\n", $u); // especificador de signo sobre un entero negativo
?>
El resultado del ejemplo sería:
%b = '10100111101010011010101101' %c = 'A' %d = '43951789' %e = '4.39518e+7' %u = '43951789' %u = '4251015507' %f = '43951789.000000' %o = '247523255' %s = '43951789' %x = '29ea6ad' %X = '29EA6AD' %+d = '+43951789' %+d = '-43951789'
Ejemplo #7 printf(): especificadores de string
<?php
$s = 'monkey';
$t = 'many monkeys';
printf("[%s]\n", $s); // salida estándar de string
printf("[%10s]\n", $s); // justificación a la derecha con espacios
printf("[%-10s]\n", $s); // justificación a la izquierda con espacios
printf("[%010s]\n", $s); // rellenado con ceros también funciona sobre strings
printf("[%'#10s]\n", $s); // utiliza el caracter de relleno personalizado '#'
printf("[%10.10s]\n", $t); // justificación a la izquierda pero con un corte a los 10 caracteres
?>
El resultado del ejemplo sería:
[monkey] [ monkey] [monkey ] [0000monkey] [####monkey] [many monke]
Ejemplo #8 sprintf(): rellenado con ceros en integers
<?php
$isodate = sprintf("%04d-%02d-%02d", $year, $month, $day);
?>
Ejemplo #9 sprintf(): formato de moneda
<?php
$money1 = 68.75;
$money2 = 54.35;
$money = $money1 + $money2;
// echo $money producirá "123.1";
$formatted = sprintf("%01.2f", $money);
// echo $formatted producirá "123.10"
?>
Ejemplo #10 sprintf(): notación científica
<?php
$number = 362525200;
echo sprintf("%.3e", $number); // produce 3.625e+8
?>