KennisbankExamencentrum
NL · NLNederlands (Nederland)
Taal kiezen13

CKTIS / C

vfprintf — geformatteerde uitvoer vanuit va_list

vfprintf schrijft geformatteerde gegevens naar een FILE-stream en haalt de argumenten uit een va_list in plaats van uit een variadische argumentenlijst.

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

Syntax

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

vfprintf werkt zoals fprintf, maar accepteert een va_list. De benodigde headers zijn <stdio.h> en <stdarg.h>; de opmaakregels blijven hetzelfde.

Initialiseer de lijst met va_start. Gebruik de lijst na de aanroep niet opnieuw, behalve voor va_end. Maak voor een onafhankelijke doorgang eerst een kopie met va_copy en beëindig ook die kopie met va_end.

Het resultaat is het aantal geschreven tekens, of een negatieve waarde bij een uitvoer- of coderingsfout. De argumenttypen moeten overeenkomen met de opmaak; afwijkingen veroorzaken ongedefinieerd gedrag. Geef niet-vertrouwde tekst door via %s, niet als opmaak.

Voorbeelden

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

Resultaat

Items: 3

De getoonde code en het opgegeven resultaat zijn in een geïsoleerde omgeving geverifieerd met de methode die in het verificatiebewijs voor exact deze versie is vastgelegd.

Bronnen