CKTIS / C
va_start — inicijalizacija pristupa varijabilnim argumentima
Makro va_start iz <stdarg.h> inicijalizira va_list za čitanje argumenata proslijeđenih nakon trotočke. U C23 dovoljan je poziv va_start(ap).
Verzija: C23; repository compiler flag, production runtime not attested
Sintaksa
#include <stdarg.h>
void va_start(va_list ap, ...);va_start je makro, a ne funkcija. Unutar variadične funkcije inicijalizira va_list prije pristupa argumentima ...; ne vraća nikakvu vrijednost.
C23 dopušta va_start(ap). Dodatni argumenti služe za podršku starijem kodu; evaluira se samo prvi.
va_arg čita argumente redom. Kod mora znati njihov broj i tipove nakon promocija argumenata; neispravno čitanje može uzrokovati nedefinirano ponašanje.
Svaki va_start zahtijeva va_end u istoj funkciji prije njezina povratka, kao i prije ponovne inicijalizacije istog ap. Za kopiranje stanja prolaska upotrijebite va_copy.
Primjeri
#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;
}
Rezultat
60
Prikazani kôd i navedeni rezultat provjereni su u izoliranom okruženju metodom zabilježenom u dokazu provjere za ovu točnu verziju.