KennisbankExamencentrum
NL · NLNederlands (Nederland)
Taal kiezen13

CKTIS / C

va_start — toegang tot variabele argumenten initialiseren

De macro va_start uit <stdarg.h> initialiseert een va_list om argumenten te lezen die via een beletselteken zijn doorgegeven. In C23 volstaat de aanroep va_start(ap).

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

Syntax

#include <stdarg.h>
void va_start(va_list ap, ...);

va_start is een macro, geen functie. Binnen een variadische functie initialiseert deze een va_list voordat argumenten uit ... worden benaderd; de macro geeft geen waarde terug.

C23 staat va_start(ap) toe. Extra argumenten zijn bedoeld voor ondersteuning van oudere code; alleen het eerste wordt geëvalueerd.

va_arg leest achtereenvolgende argumenten. De code moet hun aantal en typen na de argumentpromoties kennen; onjuist lezen kan ongedefinieerd gedrag veroorzaken.

Elke va_start vereist vóór het terugkeren een va_end in dezelfde functie, en ook voordat dezelfde ap opnieuw wordt geïnitialiseerd. Gebruik va_copy om de voortgangstoestand te kopiëren.

Voorbeelden

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

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

int main(void)
{
    printf("%d\n", sum(3, 10, 20, 30));
    return 0;
}

Resultaat

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.

Bronnen