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;

ОПИСАНИЕ

Данный набор макросов позволяет писать мобильные функции с переменным количеством аргументов. Функциям с переменным числом аргументов [таким как ], не использующим 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); }

СМ. ТАКЖЕ

, , .

ПРИМЕЧАНИЯ

Способ определения числа аргументов зависит от вызываемой функции - универсального способа (например, основанного на анализе стека) не существует. Так, при вызове execl последний аргумент должен быть нулевым указателем; printf определяет количество аргументов по формату.

Было бы ошибкой задавать в качестве второго аргумента макроса va_arg типы char, short или float, так как согласно правилам языка C перед вызовом функции аргументы типов char и short приводятся к типу int, а аргументы типа float - к типу double.

Comments: info@citmgu.ru

Содержание раздела