Función de biblioteca C -fprintf()

C 标准库 - <stdio.h>Biblioteca estándar de C - <stdio.h>

Descripción

Función de biblioteca Cint fprintf(FILE *stream, const char *format, ...)Envía la salida formateada al flujo (stream).

Declaración

A continuación se muestra la declaración de la función fprintf().

int fprintf(FILE *stream, const char *format, ...)

Parámetros

  • stream-- Este es el puntero al objeto FILE que identifica el flujo.
  • format-- Esta es una cadena de C que contiene el texto que se escribirá en el flujo (stream). Puede contener etiquetas de formato incrustadas; las etiquetas de formato pueden ser reemplazadas por los valores especificados en los parámetros adicionales posteriores y formateadas según sea necesario. Los atributos de la etiqueta de formato son %[flags][width][.precision][length]specifier,y se explican en detalle a continuación:
especificador (specifier)Salida
cCarácter
d o iEntero decimal con signo
eNotación científica usando el carácter e (mantisa y exponente)
ENotación científica usando el carácter E (mantisa y exponente)
fNúmero de punto flotante decimal
gSelecciona automáticamente la representación adecuada entre %e o %f
GSelecciona automáticamente la representación adecuada entre %E o %f
oOctal con signo
sCadena de caracteres
uEntero decimal sin signo
xEntero hexadecimal sin signo
XEntero hexadecimal sin signo (letras mayúsculas)
pDirección de puntero
nSin salida
%Carácter

indicadores (flags)Descripción
-Alinear a la izquierda dentro del ancho de campo dado; por defecto se alinea a la derecha (véase el subespecificador width).
+Fuerza a mostrar el signo más o menos (+ o -) antes del resultado, es decir, se mostrará un signo + antes de los números positivos. De forma predeterminada, solo se muestra un signo - antes de los números negativos.
(space)Si no se escribe ningún signo, se inserta un espacio antes del valor.
#Cuando se usa con los especificadores o, x o X, se muestra 0, 0x o 0X respectivamente antes de un valor distinto de cero.
Cuando se usa con e, E y f, obliga a que la salida incluya un punto decimal, incluso si no hay dígitos después. De forma predeterminada, si no hay dígitos después, no se muestra el punto decimal.
Cuando se usa con g o G, el resultado es el mismo que con e o E, pero los ceros finales no se eliminan.
0Coloca ceros (0) a la izquierda de los números al rellenar (padding), en lugar de espacios (véase el subespecificador width).

ancho (width)Descripción
(number)El número mínimo de caracteres a generar. Si el valor de salida es más corto que este número, el resultado se rellena con espacios. Si el valor de salida es más largo que este número, el resultado no se trunca.
*El ancho no se especifica en la cadena format, pero se coloca como un parámetro de valor entero adicional antes del parámetro que se va a formatear.

.precision (precisión)Descripción
.numberPara los especificadores de entero (d, i, o, u, x, X): precision especifica el número mínimo de dígitos que se deben escribir. Si el valor escrito es más corto que ese número, el resultado se rellena con ceros a la izquierda. Si el valor escrito es más largo que ese número, el resultado no se trunca. Una precisión de 0 significa que no se escribe ningún carácter.
Para los especificadores e, E y f: el número de dígitos decimales que se deben generar después del punto decimal.
Para los especificadores g y G: el número máximo de dígitos significativos a generar.
Para s: el número máximo de caracteres a generar. De forma predeterminada, se generan todos los caracteres hasta que se encuentra el carácter nulo final.
Para el tipo c: no tiene ningún efecto.
Cuando no se especifica ninguna precisión, el valor predeterminado es 1. Si se especifica sin un valor explícito, se asume que es 0.
.*La precisión no se especifica en la cadena format, pero se coloca como un parámetro de valor entero adicional antes del parámetro que se va a formatear.

length (longitud)Descripción
hEl parámetro se interpreta como short int o unsigned short int (solo para especificadores de entero: i, d, o, u, x y X).
lEl parámetro se interpreta como long int o unsigned long int; se aplica a los especificadores de entero (i, d, o, u, x y X) y a los especificadores c (que representa un carácter ancho) y s (que representa una cadena de caracteres anchos).
LEl parámetro se interpreta como long double (solo para especificadores de coma flotante: e, E, f, g y G).
  • Parámetros adicionales-- Dependiendo de la cadena format, la función puede requerir una serie de parámetros adicionales; cada parámetro contiene un valor que se insertará y reemplazará a cada etiqueta % especificada en el parámetro format. El número de parámetros debe ser el mismo que el número de etiquetas %.

Valor de retorno

Si tiene éxito, devuelve el número total de caracteres escritos; de lo contrario, devuelve un número negativo.

Ejemplo

El siguiente ejemplo demuestra el uso de la función fprintf().

Ejemplo

#include <stdio.h>
#include <stdlib.h>

int main()
{
   FILE * fp;

   fp = fopen ("file.txt", "w+");
   fprintf(fp, "%s %s %s %d", "We", "are", "in", 2014);
   
   fclose(fp);
   
   return(0);
}

Compilemos y ejecutemos el programa anterior; esto creará el archivofile.txt,cuyo contenido es el siguiente:

We are in 2014

Ahora usemos el siguiente programa para ver el contenido del archivo anterior:

Ejemplo

#include <stdio.h>

int main ()
{
   FILE *fp;
   int c;

   fp = fopen("file.txt","r");
   while(1)
   {
      c = fgetc(fp);
      if( feof(fp) )
      {
          break ;
      }
      printf("%c", c);
   }
   fclose(fp);
   return(0);
}

C 标准库 - <stdio.h>Biblioteca estándar de C - <stdio.h>

Otras extensiones