Función de la biblioteca C -vprintf()

C 标准库 - <stdio.h>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
cCarácter
d o iEntero decimal con signo
eNotación científica que utiliza el carácter e (mantisa y exponente)
ENotación científica que utiliza el carácter E (mantisa y exponente)
fNúmero de punto flotante decimal
gSelección automática de la representación adecuada entre %e o %f
GSelección automática de 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
-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.
0Coloca 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
.numberPara 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
hEl 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).
lEl 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).
LEl 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);
}

Compilemos y ejecutemos el programa anterior; esto producirá el siguiente resultado:

1 variable argument
2 variable arguments

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

Otras extensiones