CKTIS / C
vsnprintf — formattare una va_list in un buffer di capacità limitata
vsnprintf formatta gli argomenti forniti tramite una va_list. Limita le scritture alla capacità del buffer e la lunghezza restituita consente di rilevare un output troncato.
Versione: C23; repository compiler flag, production runtime not attested
Sintassi
#include <stdarg.h>
#include <stdio.h>
int vsnprintf(char * restrict s, size_t n, const char * restrict format, va_list arg);vsnprintf funziona come snprintf, ma accetta una va_list invece degli argomenti .... Serve per creare funzioni di formattazione personalizzate.
n è la capacità del buffer in byte, compreso il \0 finale. Per n > 0, scrive al massimo n - 1 byte di output e un terminatore. Per n == 0, non scrive nulla; s può essere NULL.
Il risultato r è la lunghezza necessaria senza il terminatore; un valore negativo indica un errore di codifica. Controlla prima r < 0. Se r non è negativo e n > 0, la condizione (unsigned int)r >= n indica che l’output è stato troncato. La conversione a unsigned int conserva ogni valore non negativo di tipo int, anche se size_t non può rappresentarlo.
Inizializza la lista con va_start e concludila con va_end; la funzione non esegue quest’ultima operazione. Per un altro passaggio, usa va_copy prima di consumare la lista e concludi anche la copia. I tipi degli argomenti devono corrispondere al formato; oggetti copiati sovrapposti causano un comportamento indefinito. Passa il testo non attendibile come dato per %s, non come formato.
Esempi
#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;
}Risultato
text=item:12 needed=10 truncated=1
Il codice mostrato e il risultato dichiarato sono stati verificati in un ambiente isolato con il metodo registrato nella prova di verifica di questa versione esatta.