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

Функции с переменным числом аргументов — это функции (например, 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` (определение типа)

Пример

#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/cpp/utility/variadic