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.