CKTIS / C
vsprintf — formattare in un buffer usando va_list
vsprintf scrive testo formattato in un buffer e ricava gli argomenti da una va_list. Non riceve la dimensione del buffer.
Versione: C23; repository compiler flag, production runtime not attested
Sintassi
#include <stdarg.h>
#include <stdio.h>
int vsprintf(char * restrict s, const char * restrict format, va_list arg);vsprintf funziona come sprintf, ma accetta una va_list invece di argomenti .... Scrive inoltre in s un carattere nullo di terminazione.
Il buffer deve contenere l’intero risultato e il carattere nullo. Un overflow e la copia tra oggetti sovrapposti causano un comportamento indefinito. I tipi degli argomenti devono corrispondere agli specificatori del formato. Non usare testo non attendibile come format; scegli vsnprintf per limitare le scritture.
Inizializza la lista con va_start. La funzione non chiama va_end: fallo tu. Dopo la chiamata, non leggere di nuovo la lista. Per un’iterazione indipendente, prepara prima una copia con va_copy.
Il valore restituito indica il numero di caratteri scritti, escluso il carattere terminatore, oppure è negativo in caso di errore di codifica.
Esempi
#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;
}
Risultato
score=7 7
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.