WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

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.

Quellen