База знанияИзпитен център
BGБългарски
Избери език13

CKTIS / C

<stdarg.h> — вариадични аргументи

Хедърът <stdarg.h> предоставя va_list и макроси за четене на неназованите аргументи на функции с ... и копиране на състоянието на четене.

Версия: C23; repository compiler flag, production runtime not attested

Синтаксис

#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 инициализира va_list; C23 допуска va_start(ap) без последния именуван параметър. va_arg(ap, type) извлича следващия аргумент. Броят на аргументите се определя от договора при извикване, а не от хедъра.

va_copy създава независимо състояние на четене; присвояването не е преносима замяна. Всяка инициализация изисква va_end в същата функция.

Вземете предвид промоциите на аргументите по подразбиране: float се преобразува в double, а типовете, които подлежат на целочислена промоция, се преобразуват в int или unsigned int. В C23 аргумент от тип signed _BitInt(8), който не е битово поле, не подлежи на целочислена промоция. Извлечете го с va_arg(ap, signed _BitInt(8)), а не с va_arg(ap, int). Използването на несъвместим тип извън изключенията, предвидени в стандарта, или четенето след края на списъка с аргументи води до неопределено поведение.

Примери

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

Резултат

60 60

Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.

Източници