va_start
Defined in header <cstdarg> | ||
|---|---|---|
void va_start( va_list ap, parm_n ); |
The va_start macro enables access to the variable arguments following the named argument parm_n.
va_start should be invoked with an instance to a valid va_list object ap before any calls to va_arg.
If parm_n is declared with reference type or with a type not compatible with the type that results from default argument promotions, the behavior is undefined.
Parameters
| ap | - | an instance of the va_list type |
| parm_n | - | the named parameter preceding the first variable parameter |
Expanded value
(none).
Notes
va_start is required to support parm_n with overloaded operator&.
Example
#include <iostream>
#include <cstdarg>
int add_nums(int count, ...)
{
int result = 0;
va_list args;
va_start(args, count);
for (int i = 0; i < count; ++i) {
result += va_arg(args, int);
}
va_end(args);
return result;
}
int main()
{
std::cout << add_nums(4, 25, 25, 50, 50) << '\n';
}Output:
150
See also
| accesses the next variadic function argument (function macro) |
|
| ends traversal of the variadic function arguments (function macro) |
© cppreference.com
Licensed under the Creative Commons Attribution-ShareAlike Unported License v3.0.
http://en.cppreference.com/w/cpp/utility/variadic/va_start