WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

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.

Quellen