Spec-Zone.ru › C

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

См. также

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

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

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API