Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

CKTIS / C

va_start — inicializace přístupu k proměnným argumentům

Makro va_start z <stdarg.h> inicializuje va_list pro čtení argumentů předaných pomocí tří teček. V C23 stačí zavolat va_start(ap).

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

Syntaxe

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

va_start je makro, nikoli funkce. Uvnitř variadické funkce inicializuje va_list před přístupem k argumentům ...; nevrací žádnou hodnotu.

C23 umožňuje zápis va_start(ap). Další argumenty slouží k podpoře staršího kódu; vyhodnocuje se pouze první.

va_arg čte argumenty postupně. Kód musí znát jejich počet a typy po argumentových proměnách; nesprávné čtení může způsobit nedefinované chování.

Každé va_start vyžaduje va_end ve stejné funkci před jejím návratem, a také před opětovnou inicializací stejného ap. Ke kopírování stavu průchodu použijte va_copy.

Příklady

#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;
}

Výsledek

60

Zobrazený kód a uvedený výsledek byly ověřeny v izolovaném prostředí metodou zaznamenanou v dokladu o ověření této přesné verze.

Zdroje