CKTIS / C
va_arg — het volgende argument lezen
De macro va_arg uit <stdarg.h> leest het volgende argument in het ...-gedeelte van een functie en schuift de va_list-status op.
Versie: C23; repository compiler flag, production runtime not attested
Syntax
#include <stdarg.h>
va_arg(ap, type)va_arg(ap, type) is een macro, geen functie. De macro geeft het volgende argument terug als een expressie van het type type en schuift ap op. Initialiseer de lijst met va_start of va_copy, zonder dat daarna va_end is aangeroepen.
In het algemeen moet type overeenkomen met het type na de standaardpromoties van argumenten. Lees een doorgegeven float als double. Het type char wordt gepromoveerd tot int als int alle waarden van char kan weergeven, en anders tot unsigned int. Gebruik het type dat uit die promotie volgt. Als char tot unsigned int is gepromoveerd, leidt het lezen van een waarde groter dan INT_MAX als int tot ongedefinieerd gedrag: de uitzondering voor corresponderende gehele typen met en zonder teken geldt alleen als de waarde in beide typen kan worden weergegeven. Afgezien van de uitzonderingen in de standaard leidt een incompatibel type tot ongedefinieerd gedrag; voorbij het einde lezen doet dat ook. De macro kan het einde niet detecteren: gebruik een afgesproken protocol, zoals een teller.
Elke va_start of va_copy vereist een bijbehorende va_end in dezelfde functie. Het voorbeeld leest drie waarden van het type double; count geeft het aantal aan.
Voorbeelden
#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;
}
Resultaat
7.0
De getoonde code en het opgegeven resultaat zijn in een geïsoleerde omgeving geverifieerd met de methode die in het verificatiebewijs voor exact deze versie is vastgelegd.