Base de connaissancesCentre d’examen
FRFrançais
Choisir la langue13

CKTIS / C

vsprintf — formater dans un tampon avec va_list

vsprintf écrit du texte formaté dans un tampon en récupérant les arguments depuis une va_list. Elle ne reçoit pas la taille du tampon.

Version : C23; repository compiler flag, production runtime not attested

Syntaxe

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

vsprintf fonctionne comme sprintf, mais accepte une va_list au lieu d’arguments .... Elle écrit également un caractère nul de fin dans s.

Le tampon doit pouvoir contenir le résultat complet ainsi que le caractère nul. Un dépassement et la copie entre des objets qui se chevauchent entraînent un comportement indéfini. Les types des arguments doivent correspondre aux spécificateurs de format. N’utilisez pas de texte non fiable comme format ; choisissez vsnprintf pour limiter les écritures.

Initialisez la liste avec va_start. La fonction n’appelle pas va_end : faites-le vous-même. Ne relisez pas la liste après l’appel. Pour la parcourir indépendamment, préparez auparavant une copie avec va_copy.

La valeur de retour indique le nombre de caractères écrits, sans compter le caractère final, ou est négative en cas d’erreur d’encodage.

Exemples

#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;
}

Résultat

score=7
7

Le code affiché et le résultat déclaré ont été vérifiés dans un environnement isolé selon la méthode consignée dans la preuve de vérification de cette version exacte.

Sources