Función de la biblioteca C -vfprintf()

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

Descripción

Función de la biblioteca Cint vfprintf(FILE *stream, const char *format, va_list arg)Envía salida formateada a la secuencia stream mediante una lista de argumentos.

Declaración

La siguiente es la declaración de la función vfprintf().

int vfprintf(FILE *stream, const char *format, va_list arg)

Parámetros

  • streamEste es un puntero a un objeto FILE que identifica el flujo.
  • formatEs una cadena de C que contiene el texto a escribir en el flujo stream. Puede contener etiquetas de formato incrustadas que pueden ser reemplazadas por los valores especificados en los argumentos adicionales posteriores y formateadas según sea necesario. Los atributos de la etiqueta de formato son %[flags][width][.precision][length]specifier, y se explican a continuación:
specifier (especificador)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 coma 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

flags (indicadores)Descripción
-Alinear a la izquierda dentro del ancho de campo dado; por defecto se alinea a la derecha (ver subespecificador width).
+Fuerza la visualización de un signo más o menos (+ o -) antes del resultado; es decir, los números positivos mostrarán un signo + delante. Por defecto, solo los números negativos muestran un signo - delante.
(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, los valores distintos de cero muestran 0, 0x o 0X respectivamente delante.
Cuando se usa con e, E y f, fuerza la salida a incluir un punto decimal, incluso si no hay dígitos después. Por defecto, 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 que se rellenan, en lugar de espacios (ver subespecificador width).

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

.precision (precisión)Descripción
.numberPara los especificadores de enteros (d, i, o, u, x, X): precision especifica el número mínimo de dígitos a escribir. Si el valor escrito es más corto que esta cifra, el resultado se rellena con ceros a la izquierda. Si el valor escrito es más largo, 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 a imprimir 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. Por defecto, todos los caracteres se generan hasta encontrar 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 0.
.*La precisión no se especifica en la cadena de formato, pero se coloca como un parámetro de valor entero adicional antes del argumento que se va a formatear.

length (longitud)Descripción
hEl argumento se interpreta como un entero corto (short) o un entero corto sin signo (solo para especificadores de enteros: i, d, o, u, x y X).
lEl argumento se interpreta como un entero largo (long) o un entero largo sin signo, aplicable a los especificadores de enteros (i, d, o, u, x y X) y a los especificadores c (para un carácter ancho) y s (para una cadena de caracteres anchos).
LEl argumento se interpreta como un tipo long double (solo para especificadores de coma flotante: e, E, f, g y G).
  • argUn objeto que representa una lista de argumentos variables. Debe inicializarse con la macro va_start definida en <stdarg>.

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 vfprintf().

#include <stdio.h>
#include <stdarg.h>

void WriteFrmtd(FILE *stream, char *format, ...)
{
   va_list args;

   va_start(args, format);
   vfprintf(stream, format, args);
   va_end(args);
}

int main ()
{
   FILE *fp;

   fp = fopen("file.txt","w");

   WriteFrmtd(fp, "This is just one argument %d \n", 10);

   fclose(fp);
   
   return(0);
}

Compilemos y ejecutemos el programa anterior; esto abrirá el archivo en el directorio actualfile.txt, y escribirá el siguiente contenido:

This is just one argument 10

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

#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