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.