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

CKTIS / C

vprintf — sortie formatée à partir d’une va_list

vprintf écrit du texte formaté dans stdout à partir des arguments d’une va_list. Cette fonction permet de créer des fonctions de sortie personnalisées qui acceptent un nombre variable d’arguments.

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

Syntaxe

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

vprintf fonctionne comme printf, mais accepte une va_list au lieu d’arguments transmis avec .... Elle écrit dans stdout ; vfprintf permet de choisir un flux.

Initialisez la liste avec va_start. Après l’appel, ne la réutilisez pas sans la réinitialiser ; appelez va_end. Pour effectuer un parcours indépendant, utilisez d’abord va_copy, puis un appel distinct à va_end.

S’il reste des arguments après le traitement de l’intégralité du format, les arguments excédentaires sont ignorés. Le comportement est indéfini s’il manque des arguments ou si, après les promotions d’arguments par défaut, le type d’un argument ne correspond pas au type exigé par la spécification de conversion correspondante. Passez le texte non fiable comme donnée pour %s, et non comme format.

La valeur de retour indique le nombre de caractères transmis, ou est négative en cas d’erreur de sortie ou d’encodage. L’exemple attend 10, y compris \n.

Exemples

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

static int print_message(const char *format, ...)
{
    va_list args;
    va_start(args, format);
    int result = vprintf(format, args);
    va_end(args);
    return result;
}

int main(void)
{
    int count = print_message("%s: %d\n", "Score", 42);
    if (count != 10) {
        return EXIT_FAILURE;
    }
    if (fflush(stdout) == EOF) {
        return EXIT_FAILURE;
    }
    return EXIT_SUCCESS;
}

Résultat

Score: 42

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