CKTIS / C
vprintf — formatierte Ausgabe aus einer va_list
vprintf schreibt mithilfe der Argumente aus einer va_list formatierten Text nach stdout. Damit lassen sich eigene Ausgabefunktionen erstellen, die eine variable Anzahl von Argumenten annehmen.
Version: C23; repository compiler flag, production runtime not attested
Syntax
#include <stdarg.h>
#include <stdio.h>
int vprintf(const char * restrict format, va_list arg);vprintf verhält sich wie printf, nimmt jedoch statt Argumenten über ... eine va_list entgegen. Die Ausgabe erfolgt nach stdout; mit vfprintf lässt sich ein Stream auswählen.
Initialisiere die Liste mit va_start. Verwende sie nach dem Aufruf nicht erneut, ohne sie neu zu initialisieren; rufe va_end auf. Für einen unabhängigen Durchlauf verwendest du zuerst va_copy und anschließend ein separates va_end.
Bleiben nach der Verarbeitung des gesamten Formats Argumente übrig, werden sie ignoriert. Undefiniertes Verhalten tritt auf, wenn zu wenige Argumente vorliegen oder wenn der Typ eines Arguments nach den Standard-Argumentpromotionen nicht dem von der zugehörigen Konversionsspezifikation geforderten Typ entspricht. Übergib nicht vertrauenswürdigen Text als Daten für %s, nicht als Format.
Der Rückgabewert gibt die Anzahl der übertragenen Zeichen an oder ist bei einem Ausgabe- oder Kodierungsfehler negativ. Das Beispiel erwartet 10, einschließlich \n.
Beispiele
#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;
}Ergebnis
Score: 42
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.