fprintf

(PHP 5)

fprintf -- Escribir una cadena con formato a una secuencia

Descripción

int fprintf ( resource gestor, string formato [, mixed args])

Escribe una cadena producida de acuerdo a la cadena de formato formato al recurso de secuencia especificado por gestor.

La cadena de formato está compuesta por cero o más directivas: caracteres ordinarios (excluyendo %) que son copiados directamente en el resultado, y especificaciones de conversión, cada uno de los cuales resulta en la recuperación de su propio parámetro. Esto se aplica en fprintf(), sprintf(), y printf().

Cada especificación de conversión consiste en un signo de porcentaje (%), seguido de uno o más de estos elementos, en orden:

  1. Un especificador de relleno opcional que indica qué caracter será usado para rellenar los resultados al lado derecho del tamaño de la cadena. Éste puede ser un caracter de espacio o un 0 (el caracter de cero). La acción predeterminada es realizar el relleno con espacios. Un caracter de relleno alternativo puede ser especificado si se precede con una comilla simple ('). Vea los ejemplos más adelante.

  2. Un especificador de alineación opcional que dice si el resultado debería ser alineado sobre la izquierda o sobre la derecha. La acción predeterminada es la alineación a la derecha; un caracter - en este lugar hará que la alineación se efectuara a la izquierda.

  3. Un número opcional, un especificador de ancho que dice cuántos caracteres (mínimo) debe producir esta conversión.

  4. Un especificador de precisión opcional que dice cuántos dígitos decimales deben ser mostrados para los números de punto flotante. Esta opción no tiene ningún efecto sobre otros tipos de datos diferentes a float. (Otra función útil para el formato de números es number_format().)

  5. Un especificador de tipo que dice el tipo de argumento usado para tratar los datos. Los posibles tipos:

    % - un caracter de porcentaje literal. No requiere 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 correspondiente al valor ASCII dado.
    d - el argumento es tratado como un entero, y presentado como un número decimal (con signo).
    u - el argumento es tratado como un entero, y presentado como un número decimal sin signo.
    f - el argumento es tratado como un float, y presentado como un número con punto flotante.
    o - el argumento es tratado como un entero, y presentado como un número octal.
    s - el argumento es tratado y presentado como una cadena.
    x - el argumento es tratado como un entero y presentado como un número hexadecimal (con letras minúsculas).
    X - el argumento es tratado como un entero y presentado como un número hexadecimal (con letras mayúsculas).

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

Ejemplos

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

<?php
$fecha_iso
= sprintf("%04d-%02d-%02d", $anyo, $mes, $dia);
?>

Ejemplo 2. sprintf(): dando formato a valores monetarios

<?php
$dinero1
= 68.75;
$dinero2 = 54.35;
$dinero = $dinero1 + $dinero2;
// echo $dinero producira la salida "123.1";

$con_formato = sprintf("%01.2f", $dinero);
// echo $con_formato producira la salida "123.10"
?>