Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

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.

Fonti