Майкл Джонсон - Разработка приложений в среде Linux. Второе издание

Во время обработки параметров обратный вызов можно инициировать в трех точках: до начала обработки, при нахождении параметра в таблице для данного обратного вызова и после завершения обработки. Это дает библиотекам возможность инициализировать любые необходимые им структуры (включая данные, определяемые членом descrip), и выполнять любые служебные действия, которые могут понадобиться после завершения обработки (например, очищать динамическую память, выделенную для члена descrip). Они всегда вызываются при нахождении параметра, однако в таблице параметров необходимо указать, что их нужно вызывать в двух других местах. Чтобы сделать это, значения POPT_CBFLAG_PREили POPT_CBFLAG_POST(или оба) должны объединяться битовым "ИЛИ" со значением POPT_ARG_CALLBACK, присвоенным члену argструктуры, которая определяет обратный вызов.

Далее показан прототип, который следует использовать для определения функции обратного вызова:

void callback(poptContext con, enum poptCallbackReason reason,

const struct poptOption * opt, const char * arg,

const void * data);

Первый параметр представляет содержимое, синтаксический анализ которого будет выполнен во время инициирования обратного вызова. Следующим параметров является POPT_CALLBACK_REASON_PRE, если обработка параметра еще не началась, POPT_CALLBACK_REASON_POST, если обработка параметров завершена, или POPT_CALLBACK_REASON_OPTION, если в таблице для данного обратного вызова был обнаружен параметр. Если этот параметр является последним, то аргумент opt будет указывать на элемент таблицы параметров для обнаруженного параметра, а аргумент argбудет указывать на строку, определяющую аргумент для данного параметра. Если ожидается аргумент, не представленный в виде строки, обратный вызов будет отвечать за проверку типа и преобразование аргумента. Последний параметр для обратного вызова, data, представляет собой значение поля descripв элементе таблицы параметров, который задает обратный вызов.

Ниже показан пример библиотеки, которая использует вложенную таблицу poptи обратные вызовы для синтаксического анализа некоторых параметров командной строки. Структура данных инициализируется до начала синтаксического анализа командной строки, а затем отображаются последние значения.

1: /* popt-lib.с */

2:

3: #include

4: #include

5:

6: struct params {

7: int height, width;

8: char*fg,*bg;

9: };

10:

11: static void callback(poptContext con,

12: enum poptCallbackReason reason,

13: const struct poptOption * opt,

14: const char * arg,

15: const void * data);

16:

17: /* Здесь сохраняются переменные, которые прошли синтаксический анализ. Обычно

18: глобальные переменные использовать не рекомендуется, зато работать с ними проще.*/

19: struct params ourParam;

20:

21: struct poptOption libTable[] = {

22: { NULL, '\0',

23: POPT_ARG_CALLBACK | POPT_CBFLAG_PRE | POPT_CBFLAG_POST,

24: callback, '\0', (void *) &ourParam, NULL },

25: { "height", 'h', POPT_ARG_STRING, NULL, '\0', NULL, NULL },

26: { "width", 'w', POPT_ARG_STRING, NULL, '\0', NULL, NULL },

27: { "fg", 'f', POPT_ARG_STRING, NULL, '\0', NULL, NULL },

28: { "bg", 'b', POPT_ARG_STRING, NULL, '\0', NULL, NULL },

29: { NULL, '\0', POPT_ARG_NONE, NULL, '\0', NULL, NULL }

30: };

31:

32: static void callback(poptContext con,

33: enum poptCallbackReason reason,

34: const struct poptOption * opt,

35: const char * arg,

36: const void * data) {

37: struct params * p = (void *) data;

38: char * chptr = NULL;

39:

40: if (reason == POPT_CALLBACK_REASON_PRE) {

41: p->height = 640;

42: p->width = 480;

43: p->fg = "white";

44: p->bg = "black";

45: } else if (reason == POPT_CALLBACK_REASON_POST) {

46: printf("используется высота %d ширина %d передний план %s фон %s\n",

47: p->height, p->width, p->fg, p->bg);

48:

49: } else {

50: switch (opt->shortName) {

51: case 'h': p->height = strtol(arg, &chptr, 10); break;

52: case 'w': p->width = strtol(arg, &chptr, 10); break;

53: case 'f' : p->fg = (char *) arg; break;

54: case 'b': p->bg = (char *) arg; break;

55: }

56:

57: if (chptr && *chptr) {

58: fprintf(stderr, "для %s ожидался числовой аргумент\n",

59: opt->longName);

60: exit(1);

61: }

62: }

63: }

64:

Программа, для которой необходимо обеспечить эти аргументы командной строки, должна включать одну дополнительную строку в своей таблице popt. Обычно этой строкой является макрос, задаваемый в заголовочном файле (подобно тому, как реализуется POPT_AUTOHELP), но в целях упрощения в данном примере мы просто явным образом покажем эту строку.

1: /* popt-nest.c */

2:

3: #include

4:

5: /* Обычно это объявление осуществляется в заголовочном файле */

6: extern struct poptOption libTable[];

7:

8: int main(int argc, const char * argv[]) {

9: poptContext optCon;

10: int rc;

11: struct poptOption options[] = {

12: { "app1", '\0', POPT_ARG_NONE, NULL, '\0' },

13: { NULL, '\0', POPT_ARG_INCLUDE_TABLE, libTable,

14: '\0', "Nested:", }

15: POPT_AUTOHELP

16: { NULL, '\0', POPT_ARG_NONE, NULL, '\0' }

17: };

18:

19: optCon = poptGetContext("popt-nest", argc, argv, options, 0);

20:

21: if ((rc = poptGetNextOpt (optCon)) < -1) {

22: fprintf(stderr, "%s: %s\n",

23: poptBadOption(optCon, POPT_BADOPTION_NOALIAS),

24: poptStrerror(rc));

25: return 1;

26: }

27:

28: return 0;

29: }

Каждая из функций popt, которая может возвращать ошибки, возвращает целочисленные значения. В случае возникновения ошибки возвращается отрицательный код. В табл. 26.2 перечислены коды возможных ошибок. После таблицы дается подробное обсуждение каждой ошибки.

Таблица 26.2. Коды ошибок popt

Приложения могут генерировать качественные сообщения об ошибках с помощью следующих двух функций.