CKTIS / C
va_start — inicjalizacja dostępu do argumentów zmiennych
Makro va_start z <stdarg.h> inicjalizuje va_list do odczytu argumentów przekazanych przez wielokropek. W C23 wystarcza wywołanie va_start(ap).
Wersja: C23; repository compiler flag, production runtime not attested
Składnia
#include <stdarg.h>
void va_start(va_list ap, ...);va_start jest makrem, nie funkcją. Wewnątrz funkcji wariadycznej inicjalizuje va_list przed odczytem argumentów ...; nie zwraca wartości.
W C23 wystarcza va_start(ap). Dodatkowe argumenty służą zgodności ze starszym kodem; obliczany jest tylko pierwszy.
va_arg odczytuje kolejne argumenty. Kod musi znać ich liczbę i typy po promocjach argumentów; błędny odczyt może powodować niezdefiniowane zachowanie.
Każde va_start wymaga va_end w tej samej funkcji przed powrotem, również przed ponowną inicjalizacją tego samego ap. Do kopiowania stanu używaj va_copy.
Przykłady
#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;
}
Wynik
60
Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.