Función de la biblioteca C -vfprintf()
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 |
|---|---|
| c | Carácter |
| d o i | Entero decimal con signo |
| e | Notación científica usando el carácter e (mantisa y exponente) |
| E | Notación científica usando el carácter E (mantisa y exponente) |
| f | Número de coma flotante decimal |
| g | Selecciona automáticamente la representación adecuada entre %e o %f |
| G | Selecciona automáticamente la representación adecuada entre %E o %f |
| o | Octal con signo |
| s | Cadena de caracteres |
| u | Entero decimal sin signo |
| x | Entero hexadecimal sin signo |
| X | Entero hexadecimal sin signo (letras mayúsculas) |
| p | Dirección de puntero |
| n | Sin 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. |
| 0 | Coloca 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 |
|---|---|
| .number | Para 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 |
|---|---|
| h | El 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). |
| l | El 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). |
| L | El 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);
}
Otras extensiones