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

 

C

Язык

Заголовочные файлы

Поддержка типов

Программные утилиты

Поддержка вариативных функций

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

Управление динамической памятью

Библиотека строк

Алгоритмы

Числа

Утилиты даты и времени

Поддержка ввода/вывода

Поддержка локализации

Поддержка конкурентности (C11)

Технические спецификации

Символьный указатель

 

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

va_start

va_arg

va_copy (C99)

va_end

va_list

 

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

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

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

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

Пример

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

Запустить этот код

#include <stdio.h>
#include <stdarg.h>
 
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);
            printf("%d\n", i);
        } else if (*fmt == 'c') {
            // Переменная типа 'char' будет преобразована к 'int'
            // Символьный литерал в C сам по себе уже имеет тип 'int'
            int c = va_arg(args, int);
            printf("%c\n", c);
        } else if (*fmt == 'f') {
            double d = va_arg(args, double);
            printf("%f\n", d);
        }
        ++fmt;
    }
 
    va_end(args);
}
 
int main(void)
{
    simple_printf("dcff", 3, 'a', 1.999, 42.5); 
}

Вывод:

3
a
1.999000
42.50000

Ссылки

• Стандарт 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++ по функциям с переменным количеством аргументов