Стандартная библиотека C -<stdarg.h>

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

stdarg.hЗаголовочный файл определяет тип переменнойva_listи три макроса, которые можно использовать для получения аргументов в функции, когда число аргументов неизвестно (то есть число аргументов переменно).

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

Переменные библиотеки

Ниже приведены типы переменных, определённые в заголовочном файле stdarg.h:

Порядковый номерПеременные и описание
1va_list
Это применимо кva_start()、va_arg()иva_end()Тип, в котором эти три макроса хранят информацию. Тип, используемый для хранения информации о переменных аргументах.

Библиотечные макросы

Ниже приведены макросы, определённые в заголовочном файле stdarg.h:

Порядковый номерМакросы и описание
1void va_start(va_list ap, last_arg)
Этот макрос инициализируетapпеременную, которуюva_argиva_endЭти макросы используются вместе.last_arg— это последний известный фиксированный параметр, переданный функции, т.е. параметр перед многоточием.
2type va_arg(va_list ap, type)
Этот макрос извлекает аргумент типаtypeследующий параметр.
3void va_end(va_list ap)
Этот макрос теперь доступен для использованияva_startФункция с переменным числом аргументов возвращается через макрос. Если он не вызван перед возвратом из функцииva_end, результат не определён.

Пример

Ниже приведён пример использования<stdarg.h>Пример реализации функции с переменным числом аргументов. Эта функция вычисляет сумму всех параметров:

Пример

#include <stdio.h>
#include <stdarg.h>

// Вычислить сумму переменных аргументов
int sum(int count, ...) {
    int total = 0;
    va_list args;
   
    // Инициализировать args для доступа к вариативным аргументам
    va_start(args, count);
   
    // Доступ к переменным аргументам по одному
    for (int i = 0; i < count; i++) {
        total += va_arg(args, int);
    }
   
    // Очистить args
    va_end(args);
   
    return total;
}

int main() {
    printf("Сумма 1, 2, 3: %d\n", sum(3, 1, 2, 3)); // Вывод 6
    printf("Сумма 4, 5, 6, 7: %d\n", sum(4, 4, 5, 6, 7)); // Вывод 22
    return 0;
}

Вывод:

Sum of 1, 2, 3: 6
Sum of 4, 5, 6, 7: 22

Разбор

  • va_list args;: объявитеva_listПеременная, используемая для доступа к вариативным аргументам.
  • va_start(args, count);: инициализируйтеargsЧтобы обойти список вариативных аргументов, начиная сcountПервый параметр после этого.
  • total += va_arg(args, int);: Получить следующий параметр в списке переменных аргументов и накопить его вtotal. Тип параметра —int。
  • va_end(args);: выполните очисткуargs。

Примечания

  • Тип каждого аргумента в списке переменных аргументов должен быть явным и должен согласованно передаваться вva_arg。
  • Использованиеva_startПосле этого необходимо использоватьva_endочисткаva_listпеременной.
  • va_start、va_argиva_endМакросы следует использовать парами внутри функции, чтобы избежать неопределённого поведения.
Другие расширения