(PHP 4, PHP 5, PHP 7)
sprintf — Devuelve un string formateado
Devuelve un string producido según el string de formateo dado por
format.
formatEl string de formateo está compuesto de cero o más directivas: caracteres ordinarios (excluyendo %) que son copiados directamente al resultado, y especificaciones de conversión, donde cada una de las cuales da lugar a extraer su propio parámetro. Esto se aplica tanto para sprintf() como para 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 con qué tipo deben ser tratados los datos del argumento. Los tipos posibles son:
Las variables serán forzadas por el especificador a un tipo adecuado:
| Tipo | Especificador |
|---|---|
| string | s |
| integer | d, u, c, o, x, X, b |
| double | g, G, e, E, f, F |
Intentar usar una combinación de especificadores de string y ancho con conjuntos de caracteres que requieran más de un byte por carácter podría tener resultados inesperados.
El string de formato soporta la numeración/intercambio de argumentos. Aquí está un ejemplo:
Ejemplo #1 Intercambio de argumentos
<?php
$num = 5;
$ubicación = 'árbol';
$formato = 'Hay %d monos en el %s';
echo sprintf($formato, $num, $ubicación);
?>
Ejemplo #2 Intercambio de argumentos
<?php
$formato = 'El %s contiene %d monos';
echo sprintf($formato, $num, $ubicación);
?>
Ejemplo #3 Intercambio de argumentos
<?php
$formato = 'El %2$s contiene %1$d monos';
echo sprintf($formato, $num, $ubicación);
?>
Ejemplo #4 Intercambio de argumentos
<?php
$formato = 'El %2$s contiene %1$d monos.
Es un bonito %2$s con %1$d monos.';
echo sprintf($formato, $num, $ubicación);
?>
Ejemplo #5 Especificar un carácter de relleno
<?php
echo sprintf("%'.9d\n", 123);
echo sprintf("%'.09d\n", 123);
?>
El resultado del ejemplo sería:
......123 000000123
Ejemplo #6 Especificador de posición con otros especificadores
<?php
$formato = 'El %2$s contiene %1$04d monos';
echo sprintf($formato, $num, $ubicación);
?>
El resultado del ejemplo sería:
El árbol contiene 0005 monos
Nota:
Tratar de utilizar marcadores de posición mayores que
PHP_INT_MAXprovocará que sprintf() genere mensajes de advertencia.
El especificador de tipo c ignora el relleno y el ancho
args
...
Devuelve un string producido de acuerdo con el string de formato
format.
Ejemplo #7 printf(): ejemplos varios
<?php
$n = 43951789;
$u = -43951789;
$c = 65; // ASCII 65 es 'A'
// observar el doble %%, esto muestra un carácter '%' literal
printf("%%b = '%b'\n", $n); // representación binaria
printf("%%c = '%c'\n", $c); // muestra el carácter 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 #8 printf(): especificadores de string
<?php
$s = 'mono';
$t = 'muchos monos';
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 con strings
printf("[%'#10s]\n", $s); // utiliza el carácter 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:
[mono] [ mono] [mono ] [000000mono] [######mono] [muchos mon]
Ejemplo #9 sprintf(): valores de tipo integer rellenados con ceros
<?php
$fecha_iso = sprintf("%04d-%02d-%02d", $año, $mes, $día);
?>
Ejemplo #10 sprintf(): formato de moneda
<?php
$dinero1 = 68.75;
$dinero2 = 54.35;
$dinero = $dinero1 + $dinero2;
// echo $dinero producirá "123.1";
$formateado = sprintf("%01.2f", $dinero);
// echo $formateado producirá "123.10"
?>
Ejemplo #11 sprintf(): notación científica
<?php
$número = 362525200;
echo sprintf("%.3e", $número); // produce 3.625e+8
?>