Manual de PHP
AnteriorSiguiente

sprintf

(PHP 3, PHP 4 )

sprintf -- Devuelve una cadena con formato

Descripción

string sprintf ( string formato [, mixed args])

Devuelve una cadena producida de acuerdo a la cadena de formato.

La cadena de formato está compuesta por cero o más directivas: caracteres ordinarios (excepto %) que son copiados directamente al resultado, y especificaciones de conversión, cada una de las cuales provoca la obtención de su propio parámetro. Esto se aplica tanto a sprintf() como a printf().

Cada especificación de conversión consiste en uno de estos elementos, por orden:

  1. Un especificador de relleno opcional que indica qué caracter se utilizará para rellenar el resultado hasta el tamaño de cadena correcto. Este puede ser un espacio o un 0 (caracter cero). El valor por defecto es rellenar con espacios. Un caracter de relleno alternativo se puede especificar prefijándolo con una comilla simple ('). Vea los ejemplos más abajo.

  2. Un especificador de alineación opcional que indica si el resultado debe ser alineado a la izquierda o a la derecha. Por defecto se alinea a la derecha; un caracter - aquí lo justificará a la izquierda.

  3. Un número opcional, un especificador de ancho que dice el número de caracteres (mínimo) en que debería resultar esta conversión.

  4. Un especificador de precisión opcional que indica cuántos dígitos decimales deben mostrarse para los números en coma flotante. Esta opción no tienen efecto para otros tipos que no sean double. (Otra función útil para formatear números es number_format()).

  5. Un especificador de tipo que indica el tipo a usar para tratar los datos de los argumentos. Los tipos posibles son:

    % - un caracter literal de porcentaje. No se precisa argumento.
    b - el argumento es tratado como un entero y presentado como un número binario.
    c - el argumento es tratado como un entero, y presentado como el caracter con dicho valor ASCII.
    d - el argumento es tratado como un entero y presentado como un número decimal.
    f - el argumento es tratado como un doble y presentado como un número de coma flotante.
    o - el argumento es tratado como un entero, y presentado como un número octal.
    s - el argumento es tratado como una cadena y es presentado como tal.
    x - el argumento es tratado como un entero y presentado como un número hexadecimal (con minúsculas).
    X - el argumento es tratado como un entero y presentado como un número hexadecimal (con mayúsculas).

Vea también: printf(), sscanf(), fscanf(), y number_format().

Ejemplos

Ejemplo 1. Ejemplo de sprintf(): enteros rellenos con ceros

$fechaiso = sprintf ("%04d-%02d-%02d", $anno, $mes, $dia);

Ejemplo 2. Ejemplo de sprintf(): formateando monedas

$pelas1 = 68.75;
$pelas2 = 54.35;
$pelas = $pelas1 + $pelas2;
// echo $pelas mostrará "123.1";
$formateado = sprintf ("%01.2f", $pelas);
// echo $formateado mostrará "123.10"

AnteriorInicioSiguiente
soundexSubirsscanf