Base de conocimientosCentro de exámenes
ESEspañol
Elegir idioma13

CKTIS / C

vsprintf — formato en un búfer mediante va_list

vsprintf escribe texto con formato en un búfer y obtiene los argumentos de una va_list. No recibe el tamaño del búfer.

Versión: C23; repository compiler flag, production runtime not attested

Sintaxis

#include <stdarg.h>
#include <stdio.h>
int vsprintf(char * restrict s, const char * restrict format, va_list arg);

vsprintf funciona como sprintf, pero acepta una va_list en lugar de argumentos .... También escribe en s un carácter nulo de terminación.

El búfer debe poder contener el resultado completo y el carácter nulo. El desbordamiento y la copia entre objetos que se solapan provocan un comportamiento indefinido. Los tipos de los argumentos deben coincidir con los especificadores del formato. No uses texto no confiable como format; elige vsnprintf para limitar las escrituras.

Inicializa la lista con va_start. La función no llama a va_end: hazlo tú. No vuelvas a leer la lista después de la llamada. Si necesitas recorrerla de forma independiente, prepara antes una copia con va_copy.

El valor devuelto indica el número de caracteres escritos, sin contar el carácter nulo final, o es negativo si se produce un error de codificación.

Ejemplos

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

/* Only for calls whose complete output fits in dst. */
static int format_text(char *dst, const char *format, ...)
{
    va_list args;
    va_start(args, format);
    int result = vsprintf(dst, format, args);
    va_end(args);
    return result;
}

int main(void)
{
    char text[16];
    int count = format_text(text, "score=%d", 7);
    if (count < 0) {
        return 1;
    }
    puts(text);
    printf("%d\n", count);
    return 0;
}

Resultado

score=7
7

El código mostrado y el resultado declarado se verificaron en un entorno aislado mediante el método registrado en la evidencia de verificación de esta versión exacta.

Fuentes