WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / C

vfprintf — formatierte Ausgabe aus va_list

vfprintf schreibt formatierte Daten in einen FILE-Datenstrom und bezieht die Argumente aus einer va_list statt aus einer variadischen Argumentliste.

Version: 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 funktioniert wie fprintf, nimmt jedoch eine va_list entgegen. Die benötigten Header sind <stdio.h> und <stdarg.h>; die Formatierungsregeln bleiben gleich.

Initialisiere die Liste mit va_start. Verwende sie nach dem Aufruf nicht erneut, außer für va_end. Für einen unabhängigen Durchlauf erstellst du zuerst mit va_copy eine Kopie und beendest auch diese mit va_end.

Das Ergebnis ist die Anzahl der geschriebenen Zeichen oder ein negativer Wert bei einem Ausgabe- oder Kodierungsfehler. Die Argumenttypen müssen zum Format passen; Abweichungen führen zu undefiniertem Verhalten. Übergib nicht vertrauenswürdigen Text über %s, nicht als Format.

Beispiele

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

Ergebnis

Items: 3

Der angezeigte Code und das angegebene Ergebnis wurden in einer isolierten Umgebung mit der im Prüfnachweis für genau diese Version dokumentierten Methode verifiziert.

Quellen