Variadic arguments

Вариативные функции - это функции, которые могут вызываться с разным количеством аргументов.

Только прототипированные объявления функций могут быть вариативными. Это обозначается параметром вида ... , который должен находиться последним в списке параметров и должен следовать после как минимум одного именованного параметра (до C23) . Параметр-многоточие и предшествующий параметр должны разделяться , .

// Прототипное объявление
int printx(const char* fmt, ...); // функция объявлена таким образом
printx("hello world");     // может быть вызвана с одним
printx("a=%d b=%d", a, b); // или более аргументами
int printz(...); // OK начиная с C23 и в C++
// Ошибка до C23: ... должен следовать как минимум за одним именованным параметром
// int printy(..., const char* fmt); // Ошибка: ... должен быть последним
// int printa(const char* fmt...);   // Ошибка в C: требуется ','; OK в C++

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

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

Примечания

Хотя устаревшие (без прототипов) объявления функций позволяют последующим вызовам функций использовать любое количество аргументов, они не могут быть вариативными (начиная с C89). Определение такой функции должно указывать фиксированное количество параметров и не может использовать макросы stdarg.h .

// объявление в старом стиле, удалено в C23
int printx(); // функция, объявленная таким образом
printx("hello world");     // может быть вызвана с одним
printx("a=%d b=%d", a, b); // или более аргументами
// поведение по крайней мере одного из этих вызовов неопределено, в зависимости от
// количества параметров, которые принимает функция

Пример

#include <stdio.h>
#include <time.h>
#include <stdarg.h>
void tlog(const char* fmt,...)
{
    char msg[50];
    strftime(msg, sizeof msg, "%T", localtime(&(time_t){time(NULL)}));
    printf("[%s] ", msg);
    va_list args;
    va_start(args, fmt);
    vprintf(fmt, args);
    va_end(args);
}
int main(void)
{
   tlog("logging %d %d %d...\n", 1, 2, 3);
}

[10:21:38] logging 1 2 3...

Ссылки

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