Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / C

va_arg — odczyt następnego argumentu

Makro va_arg z <stdarg.h> odczytuje kolejny argument części ... funkcji i przesuwa stan va_list.

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

Składnia

#include <stdarg.h>
va_arg(ap, type)

va_arg(ap, type) jest makrem, nie funkcją. Zwraca następny argument jako wyrażenie typu type i przesuwa ap. Lista musi być zainicjalizowana przez va_start lub va_copy, bez późniejszego va_end.

Zasadniczo type musi odpowiadać typowi po domyślnych promocjach argumentów. Przekazany float odczytuj jako double. Typ char ulega promocji do int, jeśli int może reprezentować wszystkie wartości typu char, a w przeciwnym razie do unsigned int. Użyj typu wynikającego z tej promocji. Jeśli char uległ promocji do unsigned int, odczyt wartości większej niż INT_MAX jako int powoduje niezdefiniowane zachowanie: wyjątek dla odpowiadających sobie typów całkowitych ze znakiem i bez znaku ma zastosowanie tylko wtedy, gdy oba typy mogą reprezentować daną wartość. Poza wyjątkami określonymi w normie niezgodność typu powoduje niezdefiniowane zachowanie; to samo dotyczy odczytu poza końcem listy. Makro nie wykrywa końca — potrzebny jest ustalony protokół, np. licznik.

Każde va_start lub va_copy wymaga odpowiadającego va_end w tej samej funkcji. Przykład odczytuje trzy wartości double; count określa ich liczbę.

Przykłady

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

static double sum(int count, ...)
{
    va_list ap;
    va_start(ap, count);
    double total = 0.0;
    for (int i = 0; i < count; ++i) {
        total += va_arg(ap, double);
    }
    va_end(ap);
    return total;
}

int main(void)
{
    printf("%.1f\n", sum(3, 1.5, 2.0, 3.5));
    return 0;
}

Wynik

7.0

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

Źródła