Стандартная библиотека C -<stdarg.h>
<stdarg.h>— это заголовочный файл в стандартной библиотеке C, предоставляющий набор макросов для доступа к переменному числу аргументов.
stdarg.hЗаголовочный файл определяет тип переменнойva_listи три макроса, которые можно использовать для получения аргументов в функции, когда число аргументов неизвестно (то есть число аргументов переменно).
Функции с переменным числом аргументов обычно используют многоточие в конце списка параметров....определено.
Переменные библиотеки
Ниже приведены типы переменных, определённые в заголовочном файле stdarg.h:
| Порядковый номер | Переменные и описание |
|---|---|
| 1 | va_list Это применимо кva_start()、va_arg()иva_end()Тип, в котором эти три макроса хранят информацию. Тип, используемый для хранения информации о переменных аргументах. |
Библиотечные макросы
Ниже приведены макросы, определённые в заголовочном файле stdarg.h:
| Порядковый номер | Макросы и описание |
|---|---|
| 1 | void va_start(va_list ap, last_arg) Этот макрос инициализируетapпеременную, которуюva_argиva_endЭти макросы используются вместе.last_arg— это последний известный фиксированный параметр, переданный функции, т.е. параметр перед многоточием. |
| 2 | type va_arg(va_list ap, type) Этот макрос извлекает аргумент типаtypeследующий параметр. |
| 3 | void 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;
}
#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Макросы следует использовать парами внутри функции, чтобы избежать неопределённого поведения.