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.