CKTIS / C
va_start — inicializace přístupu k proměnným argumentům
Makro va_start z <stdarg.h> inicializuje va_list pro čtení argumentů předaných pomocí tří teček. V C23 stačí zavolat va_start(ap).
Verze: C23; repository compiler flag, production runtime not attested
Syntaxe
#include <stdarg.h>
void va_start(va_list ap, ...);va_start je makro, nikoli funkce. Uvnitř variadické funkce inicializuje va_list před přístupem k argumentům ...; nevrací žádnou hodnotu.
C23 umožňuje zápis va_start(ap). Další argumenty slouží k podpoře staršího kódu; vyhodnocuje se pouze první.
va_arg čte argumenty postupně. Kód musí znát jejich počet a typy po argumentových proměnách; nesprávné čtení může způsobit nedefinované chování.
Každé va_start vyžaduje va_end ve stejné funkci před jejím návratem, a také před opětovnou inicializací stejného ap. Ke kopírování stavu průchodu použijte va_copy.
Příklady
#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;
}
Výsledek
60
Zobrazený kód a uvedený výsledek byly ověřeny v izolovaném prostředí metodou zaznamenanou v dokladu o ověření této přesné verze.