WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / C

va_arg — das nächste Argument lesen

Das Makro va_arg aus <stdarg.h> liest das nächste Argument im ...-Teil einer Funktion und rückt den Zustand von va_list weiter.

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

Syntax

#include <stdarg.h>
va_arg(ap, type)

va_arg(ap, type) ist ein Makro, keine Funktion. Es gibt das nächste Argument als Ausdruck vom Typ type zurück und rückt ap weiter. Initialisiere die Liste mit va_start oder va_copy; danach darf kein va_end erfolgt sein.

Im Allgemeinen muss type dem Typ nach den Standardargumentpromotionen entsprechen. Lies ein übergebenes float als double. Der Typ char wird zu int befördert, wenn int alle Werte von char darstellen kann, andernfalls zu unsigned int. Verwende den Typ, der sich aus dieser Promotion ergibt. Wurde char zu unsigned int befördert, führt das Lesen eines Werts größer als INT_MAX als int zu undefiniertem Verhalten: Die Ausnahme für einander entsprechende vorzeichenbehaftete und vorzeichenlose Ganzzahltypen gilt nur, wenn der Wert in beiden Typen darstellbar ist. Abgesehen von den Ausnahmen des Standards führt eine Typabweichung zu undefiniertem Verhalten; das Lesen über das Ende hinaus ebenfalls. Das Makro kann das Ende nicht erkennen: Verwende ein vereinbartes Verfahren, etwa einen Zähler.

Jedes va_start und jedes va_copy erfordert ein passendes va_end in derselben Funktion. Das Beispiel liest drei Werte vom Typ double; count gibt ihre Anzahl an.

Beispiele

#include <stdarg.h>
#include <stdio.h>

static double sum(int count, ...)
{
    va_list ap;
    va_start(ap, count);
    double total = 0.0;
    for (int i = 0; i < count; ++i) {
        total += va_arg(ap, double);
    }
    va_end(ap);
    return total;
}

int main(void)
{
    printf("%.1f\n", sum(3, 1.5, 2.0, 3.5));
    return 0;
}

Ergebnis

7.0

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