va_start

Определено в заголовке `<stdarg.h>`
void va_start( va_list ap, parmN );		(до C23)
void va_start( va_list ap, ... );		(с C23)

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

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

Если `parmN` объявлен со спецификатором класса хранения `register`, с типом массива, с типом функции или с типом, несовместимым с типом, полученным в результате стандартных преобразований аргументов, поведение не определено.	(до C23)
Оценивается только первый аргумент, переданный в `va_start`. Любые дополнительные аргументы не расширяются и не используются каким-либо образом.	(с C23)

Параметры

ap	-	экземпляр типа `va_list`
parmN	-	именованный параметр, предшествующий первому параметру-переменной

Расширенное значение

(нет)

Пример

#include <stdio.h>
#include <stdarg.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

Ссылки

Стандарт 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.15.1.4 Макрос va_start (с. 251-252)

Стандарт C89/C90 (ISO/IEC 9899:1990):

4.8.1.1 Макрос va_start

См. также

va_arg	доступ к следующему параметру переменной функции (функциональная макрокоманда)
va_copy (C99)	создает копию параметров переменной функции (функциональная макрокоманда)
va_end	завершает обход параметров переменной функции (функциональная макрокоманда)
va_list	содержит информацию, необходимую для va_start, va_arg, va_end и va_copy (тип)
Документация C++ для `va_start`

© cppreference.com
Licensed under the Creative Commons Attribution-ShareAlike Unported License v3.0.
https://en.cppreference.com/w/c/variadic/va_start