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

CKTIS / C

vfprintf — sortie formatée depuis une va_list

vfprintf écrit des données formatées dans un flux FILE et reçoit les arguments depuis une va_list plutôt que depuis une liste d’arguments variables.

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

Syntaxe

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

vfprintf fonctionne comme fprintf, mais accepte une va_list. Les en-têtes nécessaires sont <stdio.h> et <stdarg.h> ; les règles de formatage restent les mêmes.

Initialisez la liste avec va_start. Après l’appel, ne la réutilisez pas, sauf pour va_end. Pour un parcours indépendant, créez d’abord une copie avec va_copy et terminez également cette copie avec va_end.

Le résultat est le nombre de caractères écrits, ou une valeur négative en cas d’erreur de sortie ou d’encodage. Les types des arguments doivent correspondre au format ; toute incompatibilité entraîne un comportement indéfini. Transmettez le texte non fiable avec %s, et non comme format.

Exemples

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

static int write_message(FILE *stream, const char *format, ...)
{
    va_list args;
    va_start(args, format);
    int result = vfprintf(stream, format, args);
    va_end(args);
    return result;
}

int main(void)
{
    int count = write_message(stdout, "%s: %d\n", "Items", 3);
    int flush_result = fflush(stdout);
    return count == 9 && flush_result == 0 ? EXIT_SUCCESS : EXIT_FAILURE;
}

Résultat

Items: 3

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