Función de la biblioteca C -vprintf()
Biblioteca estándar de C - <stdio.h>
Descripción
Función de la biblioteca Cint vprintf(const char *format, va_list arg)Envía la salida formateada a la salida estándar stdout utilizando una lista de argumentos.
Declaración
A continuación se muestra la declaración de la función vprintf().
int vprintf(const char *format, va_list arg)
Parámetros
- format-- Esta es una cadena que contiene el texto que se va a escribir en la salida estándar stdout. Puede contener etiquetas de formato incrustadas, las cuales 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, que se explican a continuación:
| specifier (especificador) | Salida |
|---|---|
| c | Carácter |
| d o i | Entero decimal con signo |
| e | Notación científica que utiliza el carácter e (mantisa y exponente) |
| E | Notación científica que utiliza el carácter E (mantisa y exponente) |
| f | Número de punto flotante decimal |
| g | Selección automática de la representación adecuada entre %e o %f |
| G | Selección automática de 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 |
|---|---|
| - | Alinea a la izquierda dentro del ancho de campo dado; por defecto se alinea a la derecha (consulte el 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 delante del valor. |
| # | Cuando se usa con los especificadores o, x o X, los valores distintos de cero mostrarán 0, 0x o 0X delante, respectivamente. Cuando se usa con e, E y f, se 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 al usar e o E, pero los ceros finales no se eliminan. |
| 0 | Coloca ceros (0) a la izquierda del número al rellenar el padding, en lugar de espacios (consulte el subespecificador width). |
| width (ancho) | Descripción |
|---|---|
| (number) | Número mínimo de caracteres a generar. Si el valor generado es más corto que ese número, el resultado se rellena con espacios. Si el valor generado es más largo que ese número, el resultado no se trunca. |
| * | El ancho no se especifica en la cadena de formato, sino que 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 entero (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 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 a 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. 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 que es 0. |
| .* | La precisión no se especifica en la cadena de formato, sino que 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 short int o unsigned short int (solo se aplica a los especificadores de entero: i, d, o, u, x y X). |
| l | El argumento se interpreta como long int o unsigned long int, y se aplica a los especificadores de entero (i, d, o, u, x y X) y a los especificadores c (representa un carácter ancho) y s (representa una cadena de caracteres anchos). |
| L | El argumento se interpreta como long double (solo se aplica a los especificadores de punto flotante: e, E, f, g y G). |
- arg-- Un 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 vprintf().
Ejemplo
#include <stdio.h>
#include <stdarg.h>
void WriteFrmtd(char *format, ...)
{
va_list args;
va_start(args, format);
vprintf(format, args);
va_end(args);
}
int main ()
{
WriteFrmtd("%d variable argument\n", 1);
WriteFrmtd("%d variable %s\n", 2, "arguments");
return(0);
}
#include <stdarg.h>
void WriteFrmtd(char *format, ...)
{
va_list args;
va_start(args, format);
vprintf(format, args);
va_end(args);
}
int main ()
{
WriteFrmtd("%d variable argument\n", 1);
WriteFrmtd("%d variable %s\n", 2, "arguments");
return(0);
}
Compilemos y ejecutemos el programa anterior; esto producirá el siguiente resultado:
1 variable argument 2 variable argumentsOtras extensiones