Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / C

<stdarg.h> — argumenty wariadyczne

Nagłówek <stdarg.h> udostępnia va_list i makra do odczytu nienazwanych argumentów funkcji z ... oraz kopiowania stanu odczytu.

Wersja: C23; repository compiler flag, production runtime not attested

Składnia

#include <stdarg.h>
va_list ap, copy;
va_start(ap);
value = va_arg(ap, type);
va_copy(copy, ap);
va_end(copy);
va_end(ap);

va_start inicjalizuje va_list; C23 dopuszcza va_start(ap) bez ostatniego nazwanego parametru. va_arg(ap, type) pobiera kolejny argument. Liczbę argumentów określa umowa wywołania, nie nagłówek.

va_copy tworzy niezależny stan odczytu; przypisanie nie jest przenośnym zamiennikiem. Każda inicjalizacja wymaga va_end w tej samej funkcji.

Uwzględniaj domyślne promocje argumentów: float przechodzi w double, a typy podlegające promocji całkowitoliczbowej przechodzą w int lub unsigned int. W C23 argument typu signed _BitInt(8), który nie jest polem bitowym, nie podlega takiej promocji. Pobierz go za pomocą va_arg(ap, signed _BitInt(8)), a nie va_arg(ap, int). Niezgodny typ poza wyjątkami standardu lub odczyt poza końcem listy argumentów powoduje niezdefiniowane zachowanie.

Przykłady

#include <stdarg.h>
#include <stdio.h>

static void sum_twice(int count, ...)
{
    va_list ap, copy;
    va_start(ap, count);
    va_copy(copy, ap);
    int first = 0, second = 0;
    for (int i = 0; i < count; ++i) {
        first += va_arg(ap, int);
        second += va_arg(copy, int);
    }
    va_end(copy);
    va_end(ap);
    printf("%d %d\n", first, second);
}

int main(void)
{
    sum_twice(3, 10, 20, 30);
    return 0;
}

Wynik

60 60

Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.

Źródła