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 (после promotions) не совместим с 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
|
|