CKTIS / C
va_start — inicializácia prístupu k variabilným argumentom
Makro va_start z <stdarg.h> inicializuje va_list na čítanie argumentov odovzdaných pomocou troch bodiek. V C23 stačí zavolať va_start(ap).
Verzia: C23; repository compiler flag, production runtime not attested
Syntax
#include <stdarg.h>
void va_start(va_list ap, ...);va_start je makro, nie funkcia. Vo vnútri variadickej funkcie inicializuje va_list pred prístupom k argumentom ...; nevracia žiadnu hodnotu.
C23 umožňuje zápis va_start(ap). Ďalšie argumenty slúžia na podporu staršieho kódu; vyhodnocuje sa iba prvý.
va_arg číta argumenty postupne. Kód musí poznať ich počet a typy po argumentových povýšeniach; nesprávne čítanie môže spôsobiť nedefinované správanie.
Každé va_start vyžaduje va_end v tej istej funkcii pred jej návratom, a tiež pred opätovnou inicializáciou toho istého ap. Na kopírovanie stavu prechádzania použite va_copy.
Prí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ýsledok
60
Zobrazený kód a uvedený výsledok boli overené v izolovanom prostredí metódou zaznamenanou v dôkaze o overení tejto presnej verzie.