va_arg
Определён в заголовочном файле <stdarg.h> | ||
|---|---|---|
T va_arg( va_list ap, T ); |
Макрос va_arg раскрывается в выражение типа T, соответствующее следующему параметру из va_list ap.
Перед вызовом va_arg необходимо инициализировать ap вызовом va_start или va_copy, не вызывая между ними va_end. Каждый вызов макроса va_arg изменяет ap так, чтобы он указывал на следующий аргумент переменной части списка аргументов.
Если тип следующего аргумента в ap (после продвижения типов) не совместим с T, поведение не определено, за исключением случаев, когда:
- один тип является знаковым целочисленным типом, другой — соответствующим беззнаковым целочисленным типом, и значение представимо в обоих типах; или
- один тип является указателем на void, а другой — указателем на символьный тип.
Если va_arg вызывается, когда в ap больше нет аргументов, поведение не определено.
Параметры
| ap | - | экземпляр типа va_list |
| T | - | тип следующего параметра в ap |
Раскрываемое значение
следующий параметр переменной части списка аргументов в ap
Пример
#include <math.h>
#include <stdarg.h>
#include <stdio.h>
double stddev(int count, ...)
{
double sum = 0;
double sum_sq = 0;
va_list args;
va_start(args, count);
for (int i = 0; i < count; ++i)
{
double num = va_arg(args, double);
sum += num;
sum_sq += num*num;
}
va_end(args);
return sqrt(sum_sq / count - (sum / count) * (sum / count));
}
int main(void)
{
printf("%f\n", stddev(4, 25.0, 27.3, 26.9, 25.7));
}
Вывод:
0.920258
Ссылки
- Стандарт C23 (ISO/IEC 9899:2024):
- 7.16.2.2 Макрос va_arg (стр.: TBD)
- Стандарт C17 (ISO/IEC 9899:2018):
- 7.16.1.1 Макрос va_arg (стр.: TBD)
- Стандарт C11 (ISO/IEC 9899:2011):
- 7.16.1.1 Макрос va_arg (стр.: 269–270)
- Стандарт C99 (ISO/IEC 9899:1999):
- 7.15.1.1 Макрос va_arg (стр.: 249–250)
- Стандарт C89/C90 (ISO/IEC 9899:1990):
- 4.8.1.2 Макрос va_arg
См. также
|
(C99) | создаёт копию аргументов функции с переменным числом аргументов (макрос функции) |
| завершает обход аргументов функции с переменным числом аргументов (макрос функции) |
|
содержит информацию, необходимую для va_start, va_arg, va_end и va_copy (определение типа) |
|
| обеспечивает доступ к аргументам функции с переменным числом аргументов (макрос функции) |
|
Документация по C++ для va_arg |
|
© cppreference.com
Licensed under the Creative Commons Attribution-ShareAlike Unported License v3.0.
https://en.cppreference.com/c/variadic/va_arg