VARARGS(5)
НАЗВАНИЕ
varargs - обработка списка аргументов переменной длины
СИНТАКСИС
#include <varargs.h>
va_alist
va_dcl
void va_start (pvar)
va_list pvar;
тип va_arg (pvar, тип)
va_list pvar;
void va_end (pvar)
va_list pvar;
ОПИСАНИЕ
Данный набор макросов позволяет писать мобильные функции с переменным количеством аргументов. Функциям с переменным числом аргументов [таким как printf(3S)], не
использующим varargs, присуща немобильность, так как на
различных компьютерах действуют различные соглашения о
передаче аргументов.
Va_alist используется как аргумент в заголовке функции,
которая на самом деле будет принимать переменное число
аргументов.
Макрос va_dcl раскрывается в описание va_alist. За
va_dcl не надо ставить точку с запятой.
Va_list служит типом переменной, используемой для просмотра списка аргументов.
Макрос va_start вызывается для инициализации pvar перед
просмотром списка аргументов.
Макрос va_arg вернет следующий аргумент в списке, на
который указывает pvar. Необходимо указывать ожидаемый
тип аргумента, поскольку во время выполнения узнать
его, вообще говоря, нельзя.
Макрос va_end используется для окончания просмотра.
Возможен многократный просмотр списка аргументов, каждый просмотр открывается макросом va_start и завершается макросом va_end.
ПРИМЕР
Ниже приводится возможная реализация системного вызова
execl(2).
#include <varargs.h>
#define MAXARGS 100
/* execl вызывается следующим образом:
execl (file, arg1, arg2, ..., (char *)0);
*/
execl(va_alist)
va_dcl
{
va_list ap;
char *file;
char *args [MAXARGS];
int argno=0;
va_start(ap);
file = va_arg(ap, char *);
while ((args [argno++] = va_arg(ap, char *))
!= (char *)0)
;
va_end(ap);
return execv(file, args);
}
СМ. ТАКЖЕ
exec(2), printf(3S), vprintf(3S).
ПРИМЕЧАНИЯ
Способ определения числа аргументов зависит от вызываемой функции - универсального способа (например, основанного на анализе стека) не существует. Так, при вызове execl последний аргумент должен быть нулевым указателем; printf определяет количество аргументов по формату.
Было бы ошибкой задавать в качестве второго аргумента
макроса va_arg типы char, short или float, так как согласно правилам языка C перед вызовом функции аргументы
типов char и short приводятся к типу int, а аргументы
типа float - к типу double.