Variadic functions

 

C++

Язык

Понятия (концепции)

Утилиты

Строки

Контейнеры

Алгоритмы

Итераторы

Работа с числами

Ввод / вывод

Локализация

Регулярные выражения (C++11)

Атомарные примитивы (C++11)

Потоки (C++11)

 

Утилиты библиотеки

Поддежка типов (базовые типы, RTTI, type traits)

Динамическое управление памятью

Обработка ошибок

Управление жизненным циклом программы

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

Дата и время

Функциональные объекты

initializer_list (C++11)

bitset

hash (C++11)

Реляционные операторы

rel_ops::operator!= rel_ops::operator> rel_ops::operator<= rel_ops::operator>=

Пары и кортежи

pair

tuple (C++11)

piecewise_construct_t (C++11)

piecewise_construct (C++11)

Обмен, передача и перемещение

swap

forward (C++11)

move (C++11)

move_if_noexcept (C++11)

declval (C++11)

 

Variadic функций

va_start

va_arg

va_copy

va_end

va_list

 

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

Original:

Variadic functions are functions (e.g. std::printf) which take a variable number of arguments.

The text has been machine-translated via Google Translate.
You can help to correct and verify the translation. Click here for instructions.

Статистика

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

Original:

To declare a variadic function, an ellipsis is used as the last parameter, e.g. int printf(const char *format, ...);. Parameters passed to a variadic function can be accessed using the following macros and types:

The text has been machine-translated via Google Translate.
You can help to correct and verify the translation. Click here for instructions.

Определено в файле <cstdarg>
va_start	позволяет получить доступ к переменным числом аргументов функции Original: enables access to variadic function arguments The text has been machine-translated via Google Translate. You can help to correct and verify the translation. Click here for instructions. (функция-макрос)
va_arg	доступ к следующим переменным числом аргументов функции Original: accesses the next variadic function argument The text has been machine-translated via Google Translate. You can help to correct and verify the translation. Click here for instructions. (функция-макрос)
va_copy (C++11)	makes a copy of the variadic function arguments (функция-макрос)
va_end	заканчивается обход переменным числом аргументов функции Original: ends traversal of the variadic function arguments The text has been machine-translated via Google Translate. You can help to correct and verify the translation. Click here for instructions. (функция-макрос)
va_list	содержит информацию, необходимую va_start, va_arg, va_end, и va_copy Original: holds the information needed by va_start, va_arg, va_end, and va_copy The text has been machine-translated via Google Translate. You can help to correct and verify the translation. Click here for instructions. (класс)

По умолчанию преобразований

Когда Вариативный функция вызывается, после именующее к RValue, массива в указатель, и функция в указатель преобразований, каждый аргумент, который является частью списка переменных аргументов подвергается дополнительных преобразований известный как акциях аргумент по умолчанию " ':

Original:

When a variadic function is called, after lvalue-to-rvalue, array-to-pointer, and function-to-pointer преобразований, each argument that is a part of the variable argument list undergoes additional conversions known as default argument promotions:

The text has been machine-translated via Google Translate.
You can help to correct and verify the translation. Click here for instructions.

• std::nullptr_t превращается в void*

  Original:

  std::nullptr_t is converted to void*

  The text has been machine-translated via Google Translate.
  You can help to correct and verify the translation. Click here for instructions.
• float аргументы преобразуются в double как в плавающей точкой продвижения по службе

  Original:

  float arguments are converted to double as in плавающей точкой продвижения по службе

  The text has been machine-translated via Google Translate.
  You can help to correct and verify the translation. Click here for instructions.
• bool, char, short, и незаданной перечисления преобразуются в int или более широкого целого типа, как в целое продвижения по службе

  Original:

  bool, char, short, and unscoped enumerations are converted to int or wider integer types as in целое продвижения по службе

  The text has been machine-translated via Google Translate.
  You can help to correct and verify the translation. Click here for instructions.

Только арифметика, перечислением, указателем, указателем на член, и аргументы типа класса допускаются.

Original:

Only arithmetic, enumeration, pointer, pointer to member, and class type arguments are allowed.

The text has been machine-translated via Google Translate.
You can help to correct and verify the translation. Click here for instructions.

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

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

  Original:

  Variadic templates can also be used to create functions that take variable number of arguments. They are often the better choice because they do not impose restrictions on the types of the arguments, do not perform integral and floating-point promotions, and are type safe. (начиная с C++11)

  The text has been machine-translated via Google Translate.
  You can help to correct and verify the translation. Click here for instructions.
• Если все переменные аргументы общий тип, std::initializer_list обеспечивает удобный механизм (хотя и с другой синтаксис) для доступа к переменной аргументы.

  Original:

  If all variable arguments share a common type, a std::initializer_list provides a convenient mechanism (albeit with a different syntax) for accessing variable arguments.

  The text has been machine-translated via Google Translate.
  You can help to correct and verify the translation. Click here for instructions.

Пример

#include <iostream>
#include <cstdarg>
 
void simple_printf(const char *fmt, ...)
{
    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