Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

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.

Źródła