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

CKTIS / C

vsnprintf — dar formato a una va_list en un búfer limitado

vsnprintf da formato a los argumentos proporcionados mediante una va_list. Limita las escrituras a la capacidad del búfer, y la longitud devuelta permite detectar si la salida se ha truncado.

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

Sintaxis

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

vsnprintf funciona como snprintf, pero acepta una va_list en lugar de argumentos .... Sirve para crear funciones propias de formato.

n es la capacidad del búfer en bytes, incluido el \0 final. Si n > 0, escribe como máximo n - 1 bytes de salida y un terminador. Si n == 0, no escribe nada; s puede ser NULL.

El resultado r es la longitud necesaria sin el terminador; un valor negativo indica un error de codificación. Comprueba primero r < 0. Si r no es negativo y n > 0, la condición (unsigned int)r >= n indica que la salida se ha truncado. La conversión a unsigned int conserva cualquier valor no negativo de tipo int, aunque size_t no pueda representarlo.

Inicializa la lista con va_start y finalízala con va_end; la función no hace esto último. Para otra pasada, usa va_copy antes de consumir la lista y finaliza también la copia. Los tipos de los argumentos deben coincidir con el formato; los objetos copiados que se solapan provocan un comportamiento indefinido. Pasa el texto no confiable como dato para %s, no como formato.

Ejemplos

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

static int format_to(char *dst, size_t cap, const char *fmt, ...)
{
    va_list args;
    va_start(args, fmt);
    int result = vsnprintf(dst, cap, fmt, args);
    va_end(args);
    return result;
}

int main(void)
{
    char buf[8];
    int result = format_to(buf, sizeof buf, "%s:%d", "item", 12345);
    if (result < 0) {
        return 1;
    }
    printf("text=%s\nneeded=%d\ntruncated=%d\n",
           buf, result, (unsigned int)result >= sizeof buf);
    return 0;
}

Resultado

text=item:12
needed=10
truncated=1

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