Аргументы переменной длины

Позволяет функции принимать любое количество дополнительных аргументов.

Указывается заключительным ... (кроме введения расширения пакета)(с C++11) после списка параметров объявления функции.

Когда список параметров не пустой, перед ... может стоять необязательная запятая, что указывает на функцию с переменным числом аргументов. Это обеспечивает совместимость с C (который добавил требование о запятой, когда он принял прототипы функций из C++).

// the function declared as follows
int printx(const char* fmt...);
// may be called with one or more arguments:
printx("hello world");
printx("a=%d b=%d", a, b);
 
int printx(const char* fmt, ...); // same as above (extraneous comma is allowed
                                  // for C compatibility)
int printy(..., const char* fmt); // error: ... cannot appear as a parameter
int printz(...); // valid, but the arguments cannot be accessed portably

Неявные преобразования по умолчанию

При вызове функции с переменным числом аргументов, после преобразований «lvalue-to-rvalue», «array-to-pointer» и «function-to-pointer» преобразований, каждый аргумент, являющийся частью списка аргументов переменной длины, подвергается дополнительным преобразованиям, известным как преобразования по умолчанию:

• Аргументы float преобразуются в double аналогично преобразованиям с плавающей точкой
• bool, char, short, и неименованные перечисления преобразуются в int или более широкие целочисленные типы, аналогично преобразованиям целых чисел

Разрешены только аргументы арифметического, перечислимого, указателя, указателя на член и типа класса (после преобразования). Однако, не-POD типы классов(до C++11)типы классов с подходящим нетривиальным конструктором копирования, подходящим нетривиальным конструктором перемещения или нетривиальным деструктором, вместе со скопированными перечислениями(с C++11), условно поддерживаются в потенциально вычисляемых вызовах с семантикой, определяемой реализацией (эти типы всегда поддерживаются в невычисляемых вызовах).

Поскольку параметры переменной длины имеют наименьший приоритет в целях разрешения перегрузки, они обычно используются в качестве универсальных решений в SFINAE.

В теле функции, использующей аргументы переменной длины, значения этих аргументов могут быть получены с помощью <cstdarg> средств библиотеки:

Поведение макроса va_start неопределено, если последний параметр перед многоточием имеет тип ссылки или тип, несовместимый с типом, полученным в результате преобразований по умолчанию.

Альтернативы

Примечания

В языке C до C23 перед многоточием должен быть хотя бы один именованный параметр, поэтому R printz(...); недопустим до C23. В C++, эта форма разрешена, даже если аргументы, переданные в такую функцию, недоступны, и часто используется в качестве запасного варианта перегрузки в SFINAE, используя наименьший приоритет преобразования многоточия в разрешении перегрузки.

Этот синтаксис для аргументов переменной длины был представлен в C++ 1983 без запятой перед многоточием. Когда C89 принял прототипы функций из C++, он заменил синтаксис на синтаксис, требующий запятой. Для совместимости C++98 принимает как синтаксис C++-стиля f(int n...), так и синтаксис C-стиля f(int n, ...).

Отчеты об ошибках

Следующие поведенческие отчеты об ошибках были применены ретроактивно к ранее опубликованным стандартам C++.

См. также