CKTIS / C
<stdarg.h> — variadische argumenten
De header <stdarg.h> biedt va_list en macro's om naamloze argumenten van functies met ... te lezen en de leesstatus te kopiëren.
Versie: C23; repository compiler flag, production runtime not attested
Syntax
#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 initialiseert een va_list; C23 staat va_start(ap) toe zonder de laatste benoemde parameter. va_arg(ap, type) haalt het volgende argument op. De aanroepafspraak bepaalt het aantal argumenten, niet de header.
va_copy maakt een onafhankelijke leesstatus; toewijzing is geen draagbaar alternatief. Elke initialisatie vereist va_end in dezelfde functie.
Houd rekening met de standaardpromoties voor argumenten: float wordt gepromoveerd naar double, en typen waarop integerpromotie van toepassing is, worden gepromoveerd naar int of unsigned int. In C23 geldt integerpromotie niet voor een argument van het type signed _BitInt(8) dat geen bitveld is. Haal het op met va_arg(ap, signed _BitInt(8)), niet met va_arg(ap, int). Een incompatibel type gebruiken, behalve in de gevallen die de standaard toestaat, of voorbij het einde van de argumentenlijst lezen leidt tot ongedefinieerd gedrag.
Voorbeelden
#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;
}
Resultaat
60 60
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.