Server for Information Technologies Сервер поддерживается
Центром Информационных Технологий
(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
Обновлено: 13.03.2015