CKTIS / C
va_start — Zugriff auf variable Argumente initialisieren
Das Makro va_start aus <stdarg.h> initialisiert eine va_list, damit Argumente gelesen werden können, die über eine Auslassungspunkte-Syntax übergeben wurden. In C23 genügt der Aufruf va_start(ap).
Version: C23; repository compiler flag, production runtime not attested
Syntax
#include <stdarg.h>
void va_start(va_list ap, ...);va_start ist ein Makro, keine Funktion. Innerhalb einer variadischen Funktion initialisiert es eine va_list, bevor auf Argumente aus ... zugegriffen wird; es gibt keinen Wert zurück.
C23 erlaubt va_start(ap). Zusätzliche Argumente dienen der Unterstützung älteren Codes; nur das erste wird ausgewertet.
va_arg liest die Argumente der Reihe nach. Der Code muss ihre Anzahl und die Typen nach den Argument-Promotions kennen; falsches Lesen kann undefiniertes Verhalten verursachen.
Auf jedes va_start muss in derselben Funktion vor der Rückkehr ein va_end folgen, auch bevor dasselbe ap erneut initialisiert wird. Verwende va_copy, um den Durchlaufzustand zu kopieren.
Beispiele
#include <stdarg.h>
#include <stdio.h>
static int sum(unsigned count, ...)
{
va_list ap;
va_start(ap, count);
int total = 0;
for (unsigned i = 0; i < count; ++i) total += va_arg(ap, int);
va_end(ap);
return total;
}
int main(void)
{
printf("%d\n", sum(3, 10, 20, 30));
return 0;
}
Ergebnis
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.