va_start

 

C

Compiler-Unterstützung

Sprache

Header

Typunterstützung

Programm-Dienstprogramme

Unterstützung für variable Funktionsargumente

Fehlerbehandlung

Dynamische Speicherverwaltung

Bibliothek für Zeichenketten

Algorithmen

Numerik

Datums- und Zeitdienstprogramme

Ein-/Ausgabeunterstützung

Lokalisierungsunterstützung

Unterstützung für Nebenläufigkeit (C11)

Technische Spezifikationen

Symbolindex

 

Variadische Funktionen

va_start

va_arg

va_copy (C99)

va_end

va_list

 

Definiert in Header <stdarg.h>
void va_start( va_list ap, parmN );		(bis C23)
void va_start( va_list ap, ... );		(seit C23)

Das Makro va_start ermöglicht den Zugriff auf die variablen Argumente, die auf das benannte Argument parmN folgen(bis C23).

va_start muss mit einer Instanz eines gültigen va_list-Objekts ap aufgerufen werden, bevor va_arg aufgerufen wird.

Wenn parmN mit dem Speicherklassenspezifizierer register, einem Array-Typ, einem Funktionstyp oder einem Typ deklariert wird, der nicht mit dem Typ kompatibel ist, der sich aus Standard-Argument-Promotions ergibt, ist das Verhalten undefiniert.	(bis C23)
Nur das erste Argument, das an va_start übergeben wird, wird ausgewertet. Zusätzliche Argumente werden weder expandiert noch in irgendeiner Weise verwendet.	(seit C23)

Parameter

ap	-	eine Instanz des va_list-Typs
parmN	-	der benannte Parameter, der dem ersten variablen Parameter vorausgeht

Expandierter Wert

(keine)

Beispiel

Führen Sie diesen Code aus

#include <stdio.h>
#include <stdarg.h>
 
int add_nums_C99(int count, ...)
{
    int result = 0;
    va_list args;
    va_start(args, count); // count can be omitted since C23
 
    for (int i = 0; i < count; ++i) {
        result += va_arg(args, int);
    }
 
    va_end(args);
    return result;
}
 
#if __STDC_VERSION__ > 201710L
// Same as above, valid since C23
int add_nums_C23(...)
{
    int result = 0;
    va_list args;
    va_start(args);
 
    int count = va_arg(args, int);
    for (int i = 0; i < count; ++i) {
        result += va_arg(args, int);
    }
 
    va_end(args);
    return result;
}
#endif
 
int main(void)
{
    printf("%d\n", add_nums_C99(4, 25, 25, 50, 50));
#if __STDC_VERSION__ > 201710L
    printf("%d\n", add_nums_C23(4, 25, 25, 50, 50));
#endif
}

Mögliche Ausgabe

150
150

Referenzen

• C17-Standard (ISO/IEC 9899:2018)

• 7.16.1.4 Das va_start-Makro (S. 198-199)

• C11-Standard (ISO/IEC 9899:2011)

• 7.16.1.4 Das va_start-Makro (S. 271-272)

• C99-Standard (ISO/IEC 9899:1999)

• 7.15.1.4 Das va_start-Makro (S. 251-252)

• C89/C90-Standard (ISO/IEC 9899:1990)

• 4.8.1.1 Das va_start-Makro

Siehe auch

va_arg	greift auf das nächste variadische Funktionsargument zu (function macro)
va_copy (C99)	erstellt eine Kopie der variadischen Funktionsargumente (function macro)
va_end	beendet die Durchquerung der variadischen Funktionsargumente (function macro)
va_list	enthält die von va_start, va_arg, va_end und va_copy benötigten Informationen (typedef)
C++ Dokumentation für va_start