# va_list

> C++ Atlas: `cppatlas.com/w/c/variadic/va_list` | Source: https://en.cppreference.com/w/c/variadic/va_list | Domain: Variadic functions | Standards: C99

va_list is a complete object type suitable for holding the information needed by the macros va_start, va_copy, va_arg, and va_end.

## Official Specification Summary (cppreference)

```cpp
// Defined in header <stdarg.h>
/* unspecified */ va_list;
```

`va_list` is a complete object type suitable for holding the information needed by the macros `va_start`, `va_copy`, `va_arg`, and `va_end`.

If a `va_list` instance is created, passed to another function, and used via `va_arg` in that function, then any subsequent use in the calling function should be preceded by a call to `va_end`.

It is legal to pass a pointer to a `va_list` object to another function and then use that object after the function returns.

### References

- C11 standard (ISO/IEC 9899:2011):

  - 7.16/3 Variable arguments \<stdarg.h> (p: 269)

- C99 standard (ISO/IEC 9899:1999):

  - 7.15/3 Variable arguments \<stdarg.h> (p: 249)

- C89/C90 standard (ISO/IEC 9899:1990):

  - 4.8 VARIABLE ARGUMENTS \<stdarg.h>

### See also

- [`va_arg`](https://en.cppreference.com/w/c/variadic/va_arg): accesses the next variadic function argument (function macro)
- [`va_copy`](https://en.cppreference.com/w/c/variadic/va_copy) (C99): makes a copy of the variadic function arguments (function macro)
- [`va_end`](https://en.cppreference.com/w/c/variadic/va_end): ends traversal of the variadic function arguments (function macro)
- [`va_start`](https://en.cppreference.com/w/c/variadic/va_start): enables access to variadic function arguments (function macro)
- [C++ documentation for `va_list`](https://en.cppreference.com/w/cpp/utility/variadic/va_list)

---
Attribution: content from https://en.cppreference.com/w/c/variadic/va_list (cppreference.com), licensed under CC-BY-SA 3.0 and GFDL. Modified: converted to markdown, study notes added. Offline snapshot of 9 February 2025.