CKTIS / C
va_start — toegang tot variabele argumenten initialiseren
De macro va_start uit <stdarg.h> initialiseert een va_list om argumenten te lezen die via een beletselteken zijn doorgegeven. In C23 volstaat de aanroep va_start(ap).
Versie: C23; repository compiler flag, production runtime not attested
Syntax
#include <stdarg.h>
void va_start(va_list ap, ...);va_start is een macro, geen functie. Binnen een variadische functie initialiseert deze een va_list voordat argumenten uit ... worden benaderd; de macro geeft geen waarde terug.
C23 staat va_start(ap) toe. Extra argumenten zijn bedoeld voor ondersteuning van oudere code; alleen het eerste wordt geëvalueerd.
va_arg leest achtereenvolgende argumenten. De code moet hun aantal en typen na de argumentpromoties kennen; onjuist lezen kan ongedefinieerd gedrag veroorzaken.
Elke va_start vereist vóór het terugkeren een va_end in dezelfde functie, en ook voordat dezelfde ap opnieuw wordt geïnitialiseerd. Gebruik va_copy om de voortgangstoestand te kopiëren.
Voorbeelden
#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;
}
Resultaat
60
De getoonde code en het opgegeven resultaat zijn in een geïsoleerde omgeving geverifieerd met de methode die in het verificatiebewijs voor exact deze versie is vastgelegd.