CKTIS / C
va_arg — branje naslednjega argumenta
Makro va_arg iz <stdarg.h> prebere naslednji argument v delu ... funkcije in pomakne stanje va_list.
Različica: C23; repository compiler flag, production runtime not attested
Sintaksa
#include <stdarg.h>
va_arg(ap, type)va_arg(ap, type) je makro, ne funkcija. Vrne naslednji argument kot izraz tipa type in pomakne ap. Seznam inicializirajte z va_start ali va_copy, pri čemer za tem ne sme biti klican va_end.
Na splošno se mora type ujemati s tipom po privzetih promocijah argumentov. Podani float preberite kot double. Tip char se promovira v int, če lahko int predstavi vse vrednosti tipa char, sicer pa v unsigned int. Uporabite tip, ki nastane pri tej promociji. Če se je char promoviral v unsigned int, branje vrednosti, večje od INT_MAX, kot int povzroči nedefinirano vedenje: izjema za ustrezna predznačena in nepredznačena celoštevilska tipa velja le, če je vrednost predstavljiva v obeh tipih. Razen v primerih, ki jih standard določa kot izjeme, neujemanje tipov povzroči nedefinirano vedenje; enako velja za branje prek konca seznama. Makro konca ne more zaznati: uporabite dogovorjen protokol, na primer števec.
Vsak va_start ali va_copy zahteva ustrezen va_end v isti funkciji. Primer prebere tri vrednosti double; count določa njihovo število.
Primeri
#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;
}
Rezultat
7.0
Prikazana koda in navedeni rezultat sta bila preverjena v izoliranem okolju z metodo, zapisano v dokazilu o preverjanju te natančne različice.