| Сервер поддерживается Центром Информационных Технологий (095) 932-9212, 932-9213, 939-0783 E-mail: info@citforum.ru

Сервер содержит море(!) аналитической информации | CIT Forum CD-ROM

### 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.

Comments: info@citmgu.ru Designed by Andrey Novikov Copyright © CIT