va_arg

From cppreference.com
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 to point to the next variable argument.

If the type of the next argument in ap (after promotions) is not compatible with T , the behavior is undefined, unless:

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

  • 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)