Функции с переменным числом аргументов

Функции с переменным числом аргументов (например, std::printf) — это функции, которые принимают переменное число аргументов.

Для объявления функции с переменным числом аргументов используется эллипс после списка параметров, например int printf(const char* format...);, который может предшествовать необязательная запятая. Дополнительные сведения о синтаксисе, автоматическом преобразовании аргументов и альтернативах см. в разделе Переменные аргументы.

Для доступа к аргументам функций с переменным числом аргументов из тела функции предоставляются следующие средства библиотеки:

Определено в заголовке `<cstdarg>`
va_start	обеспечивает доступ к аргументам функции с переменным числом аргументов (макрос функции)
va_arg	обращается к следующему аргументу функции с переменным числом аргументов (макрос функции)
va_copy (C++11)	создает копию аргументов функции с переменным числом аргументов (макрос функции)
va_end	завершает обход аргументов функции с переменным числом аргументов (макрос функции)
va_list	хранит информацию, необходимую для `va_start`, `va_arg`, `va_end`, и `va_copy` (typedef)

Пример

#include <cstdarg>
#include <iostream>
 
void simple_printf(const char* fmt...) // C-style "const char* fmt, ..." is also valid
{
    va_list args;
    va_start(args, fmt);
 
    while (*fmt != '\0')
    {
        if (*fmt == 'd')
        {
            int i = va_arg(args, int);
            std::cout << i << '\n';
        }
        else if (*fmt == 'c')
        {
            // note automatic conversion to integral type
            int c = va_arg(args, int);
            std::cout << static_cast<char>(c) << '\n';
        }
        else if (*fmt == 'f')
        {
            double d = va_arg(args, double);
            std::cout << d << '\n';
        }
        ++fmt;
    }
 
    va_end(args);
}
 
int main()
{
    simple_printf("dcff", 3, 'a', 1.999, 42.5); 
}

Вывод:

3
a
1.999
42.5

См. также

Документация C по Функциям с переменным числом аргументов

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