WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / C

<stdarg.h> — variable Argumente

Der Header <stdarg.h> stellt va_list und Makros bereit, um unbenannte Argumente von Funktionen mit ... auszulesen und den Lesestatus zu kopieren.

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

Syntax

#include <stdarg.h>
va_list ap, copy;
va_start(ap);
value = va_arg(ap, type);
va_copy(copy, ap);
va_end(copy);
va_end(ap);

va_start initialisiert ein va_list; C23 erlaubt va_start(ap) ohne den letzten benannten Parameter. va_arg(ap, type) ruft das nächste Argument ab. Die Aufrufvereinbarung legt die Anzahl der Argumente fest, nicht der Header.

va_copy erstellt einen unabhängigen Lesestatus; eine Zuweisung ist kein portabler Ersatz. Jede Initialisierung erfordert va_end in derselben Funktion.

Beachte die standardmäßigen Argument-Promotions: float wird zu double, und Typen, die der Ganzzahl-Promotion unterliegen, werden zu int oder unsigned int. In C23 unterliegt ein Argument vom Typ signed _BitInt(8), das kein Bitfeld ist, nicht der Ganzzahl-Promotion. Lies es mit va_arg(ap, signed _BitInt(8)) aus, nicht mit va_arg(ap, int). Ein nicht übereinstimmender Typ außerhalb der Ausnahmen des Standards oder ein Lesen über das Ende der Argumentliste hinaus führt zu undefiniertem Verhalten.

Beispiele

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

static void sum_twice(int count, ...)
{
    va_list ap, copy;
    va_start(ap, count);
    va_copy(copy, ap);
    int first = 0, second = 0;
    for (int i = 0; i < count; ++i) {
        first += va_arg(ap, int);
        second += va_arg(copy, int);
    }
    va_end(copy);
    va_end(ap);
    printf("%d %d\n", first, second);
}

int main(void)
{
    sum_twice(3, 10, 20, 30);
    return 0;
}

Ergebnis

60 60

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