Namespaces
Variants

va_start

От ru.cppreference.net
Определён в заголовке <stdarg.h>
void va_start( va_list ap, parmN );
(до C23)
void va_start( va_list ap, ... );
(начиная с C23)

Макрос va_start предоставляет доступ к переменным аргументампосле именованного аргумента parmN(до C23).

va_startОн должен быть вызван с экземпляром допустимого объекта va_listapперед любыми вызовами va_arg.

Если parmN объявлен с register спецификатором класса памяти, массивом, функцией или типом, несовместимым с типом, полученным в результате продвижения аргументов по умолчанию, поведение не определено.

(до C23)

Если для va_start присутствует более одного аргумента, токены препроцессора, составляющие второй и последующие аргументы, игнорируются. Если любой из этих аргументов разворачивается с несбалансированными скобками или содержит токен препроцессора, который не преобразуется в токен, поведение не определено.

(начиная с C23)

Параметры

ap - экземпляр типа va_list
parmN - именованный параметр перед первым переменным параметром

Разворачиваемое значение

(отсутствует)

Пример

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

int add_nums_C99(int count, ...)
{
    int result = 0;
    va_list args;
    va_start(args, count); // count can be omitted since C23
    
    for (int i = 0; i < count; ++i)
        result += va_arg(args, int);
    
    va_end(args);
    return result;
}

#if __STDC_VERSION__ > 201710L
// Same as above, valid since C23
int add_nums_C23(...)
{
    int result = 0;
    va_list args;
    va_start(args);
    
    int count = va_arg(args, int);
    for (int i = 0; i < count; ++i)
        result += va_arg(args, int);
    
    va_end(args);
    return result;
}
#endif

int main(void)
{
    printf("%d\n", add_nums_C99(4, 25, 25, 50, 50));
#if __STDC_VERSION__ > 201710L
    printf("%d\n", add_nums_C23(4, 25, 25, 50, 50));
#endif
}

Возможный вывод:

150
150

Ссылки

  • Стандарт C23 (ISO/IEC 9899:2024):
  • 7.16.1.4 Макрос va_start (стр. 290-292)
  • Стандарт C17 (ISO/IEC 9899:2018):
  • 7.16.1.4 Макрос va_start (стр. 198-199)
  • Стандарт C11 (ISO/IEC 9899:2011):
  • 7.16.1.4 Макрос va_start (стр. 271-272)
  • Стандарт C99 (ISO/IEC 9899:1999):
  • 7.16.1.4 Макрос va_start (стр. 251-252)
  • Стандарт C89/C90 (ISO/IEC 9899:1990):
  • 4.8.1.1 Макрос va_start

Смотри также

осуществляет доступ к следующему аргументу вариативной функции
(функция-макрос)
создаёт копию аргументов вариативной функции
(функция-макрос)
завершает обход аргументов вариативной функции
(функция-макрос)
содержит информацию, необходимую для va_start, va_arg, va_end и va_copy
(тип-определение)