Función de la biblioteca C -vsprintf()
Biblioteca estándar de C - <stdio.h>
Descripción
Funciones de la biblioteca Cint vsprintf(char *str, const char *format, va_list arg)Envía salida formateada a una cadena utilizando una lista de argumentos.
Declaración
A continuación se muestra la declaración de la función vsprintf().
int vsprintf(char *str, const char *format, va_list arg)
Parámetros
- str-- Este es un puntero a un arreglo de caracteres que almacena la cadena C.
- format-- Esta es una cadena que contiene el texto que se escribirá en la cadena str. Puede contener etiquetas de formato incrustadas, las cuales pueden ser reemplazadas por los valores especificados en los parámetros adicionales subsiguientes y formateadas según sea necesario. Las propiedades de la etiqueta de formato son %[flags][width][.precision][length]specifiery se explican en detalle a continuación:
| specifier (especificador) | Salida |
|---|---|
| c | Carácter |
| d o i | Entero decimal con signo |
| e | Notación científica con el carácter e (mantisa y exponente) |
| E | Notación científica con el carácter E (mantisa y exponente) |
| f | Número de punto flotante decimal |
| g | Selecciona automáticamente la representación apropiada entre %e o %f |
| G | Selecciona automáticamente la representación apropiada 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 es alineación a la derecha (ver 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. De forma predeterminada, 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 delante, respectivamente. Cuando se usa con e, E y f, fuerza la salida a incluir 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 no se eliminan los ceros finales. |
| 0 | Coloca ceros (0) a la izquierda de los números al especificar el relleno (padding), en lugar de espacios (ver el subespecificador width). |
| width (ancho) | Descripción |
|---|---|
| (number) | Número mínimo de caracteres a emitir. 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, el resultado no se trunca. |
| * | El ancho no se especifica en la cadena de formato, pero se proporciona como un parámetro de valor entero adicional colocado antes del argumento a formatear. |
| .precision (precisión) | Descripción |
|---|---|
| .number | Para 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, 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 decimales a emitir después del punto decimal. Para los especificadores g y G: el número máximo de dígitos significativos a emitir. Para s: el número máximo de caracteres a emitir. De forma predeterminada, se emiten todos los caracteres hasta que se encuentre el carácter nulo final. Para el tipo c: no tiene ningún efecto. Cuando no se especifica 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 proporciona como un parámetro de valor entero adicional colocado antes del argumento a formatear. |
| length (longitud) | Descripción |
|---|---|
| h | El argumento se interpreta como un entero corto 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 o un entero largo sin signo, aplicable a los especificadores de enteros (i, d, o, u, x y X) y a los especificadores c (que indica un carácter ancho) y s (que indica una cadena de caracteres anchos). |
| L | El argumento se interpreta como un double largo (solo para especificadores de punto flotante: e, E, f, g y G). |
- arg-- Un objeto que representa una lista de argumentos variables. Debe ser inicializado por 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 vsprintf().
#include <stdio.h>
#include <stdarg.h>
char buffer[80];
int vspfunc(char *format, ...)
{
va_list aptr;
int ret;
va_start(aptr, format);
ret = vsprintf(buffer, format, aptr);
va_end(aptr);
return(ret);
}
int main()
{
int i = 5;
float f = 27.0;
char str[50] = "example.com";
vspfunc("%d %f %s", i, f, str);
printf("%s\n", buffer);
return(0);
}
Compilemos y ejecutemos el programa anterior, esto producirá el siguiente resultado:
5 27.000000 example.comOtras extensiones