va_arg

From cppreference.com
< c‎ | variadic
Defined in header <stdarg.h>
T va_arg( va_list ap, T );

The va_arg macro expands to an expression of type T that corresponds to the next parameter from the va_list ap

Prior to calling va_arg, ap must be initialized by a call to either va_start or va_copy, with no intervening call to va_end. Each invocation of the va_arg macro modifies ap

If the type of the next argument in ap (after promotions) is not compatible with T

  • one type is a signed integer type, the other type is the corresponding unsigned integer type, and the value is representable in both types; or
  • one type is pointer to void and the other is a pointer to a character type.

If va_arg is called when there are no more arguments in ap, the behavior is undefined.

Parameters

ap - an instance of the va_list type
T - the type of the next parameter in ap

Expanded value

the next variable parameter in ap

Example

#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));
}

Output:

0.920258

References

  • C23 standard (ISO/IEC 9899:2024):
  • 7.16.2.2 The va_arg macro (p: TBD)
  • C17 standard (ISO/IEC 9899:2018):
  • 7.16.1.1 The va_arg macro (p: TBD)
  • C11 standard (ISO/IEC 9899:2011):
  • 7.16.1.1 The va_arg macro (p: 269-270)
  • C99 standard (ISO/IEC 9899:1999):
  • 7.15.1.1 The va_arg macro (p: 249-250)
  • C89/C90 standard (ISO/IEC 9899:1990):
  • 4.8.1.2 The va_arg macro

See also

(C99)
makes a copy of the variadic function arguments
(function macro)
ends traversal of the variadic function arguments
(function macro)
holds the information needed by va_start, va_arg, va_end, and va_copy
(typedef)
enables access to variadic function arguments
(function macro)