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

CKTIS / C

<stdarg.h> — variadické argumenty

Hlavička <stdarg.h> poskytuje va_list a makra pro čtení nepojmenovaných argumentů funkcí s ... a kopírování stavu čtení.

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

Syntaxe

#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 inicializuje va_list; C23 umožňuje va_start(ap) bez posledního pojmenovaného parametru. va_arg(ap, type) získá následující argument. Počet argumentů určuje smlouva volání, nikoli hlavička.

va_copy vytvoří nezávislý stav čtení; přiřazení není přenositelnou náhradou. Každá inicializace vyžaduje va_end ve stejné funkci.

Zohledněte výchozí povýšení typů argumentů: float se povyšuje na double a typy podléhající celočíselnému povýšení se povyšují na int nebo unsigned int. V C23 se celočíselné povýšení nevztahuje na argument typu signed _BitInt(8), který není bitovým polem. Načtěte jej pomocí va_arg(ap, signed _BitInt(8)), nikoli va_arg(ap, int). Použití nekompatibilního typu mimo výjimky stanovené normou nebo čtení za koncem seznamu argumentů vede k nedefinovanému chování.

Příklady

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

Výsledek

60 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