Namespaces
Variants

Variadic functions

From cppreference.net
< c

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

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

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

Содержание

Типы
содержит информацию, необходимую для работы va_start , va_arg , va_end и va_copy
(typedef)
Макросы
Определено в заголовочном файле <stdarg.h>
обеспечивает доступ к аргументам вариативной функции
(макрос-функция)
получает следующий аргумент вариативной функции
(макрос-функция)
(C99)
создаёт копию аргументов вариативной функции
(макрос-функция)
завершает обход аргументов вариативной функции
(макрос-функция)

Пример

Вывод значений различных типов.

#include <stdarg.h>
#include <stdio.h>
void simple_printf(const char* fmt, ...)
{
    va_list args;
    for (va_start(args, fmt); *fmt != '\0'; ++fmt)
    {
        switch(*fmt)
        {
            case 'd':
            {
                int i = va_arg(args, int);
                printf("%d\n", i);
                break;
            }
            case 'c':
            {
                // A 'char' variable will be promoted to 'int'
                // A character literal in C is already 'int' by itself
                int c = va_arg(args, int);
                printf("%c\n", c);
                break;
            }
            case 'f':
            {
                double d = va_arg(args, double);
                printf("%f\n", d);
                break;
            }
            default:
                puts("Unknown formatter!");
                goto END;
        }
    }
END:
    va_end(args);
}
int main(void)
{
    simple_printf("dcff", 3, 'a', 1.969, 42.5);
}

Вывод:

3
a
1.969000
42.50000

Ссылки

  • Стандарт C23 (ISO/IEC 9899:2024):
  • 7.16 Переменное количество аргументов <stdarg.h> (стр.: TBD)
  • Стандарт C17 (ISO/IEC 9899:2018):
  • 7.16 Переменное количество аргументов <stdarg.h> (стр.: TBD)
  • Стандарт C11 (ISO/IEC 9899:2011):
  • 7.16 Переменное количество аргументов <stdarg.h> (стр: 269-272)
  • Стандарт C99 (ISO/IEC 9899:1999):
  • 7.15 Переменное количество аргументов <stdarg.h> (стр: 249-252)
  • Стандарт C89/C90 (ISO/IEC 9899:1990):
  • 4.8 ПЕРЕМЕННОЕ ЧИСЛО АРГУМЕНТОВ <stdarg.h>

Смотрите также

Документация C++ для Variadic functions