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

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: }

26.4. Обработка ошибок

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

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

Код ошибки	Описание
POPT_ERROR_NOARG	Отсутствует аргумент для данного параметра.
POPT_ERROR_BADOPT	Невозможно проанализировать синтаксис аргумента параметра.
POPT_ERROR_OPTSTOODEEP	Слишком глубокое вложение замещений имени параметра.
POPT_ERROR_BADQUOTE	Несоответствие кавычек.
POPT_ERROR_BADNUMBER	Невозможно преобразовать параметр в число.
POPT_ERROR_OVERFLOW	Данное число слишком большое или слишком маленькое.
POPT_ERROR_NOARG	Параметр, для которого требуется аргумент, был определен в командной строке, однако аргумент не был предоставлен. Эта ошибка может быть возвращена только функцией poptGetNextOpt.
POPT_ERROR_BADOPT	Параметр был определен в массиве argv, однако его нет в таблице параметров. Эта ошибка может быть возвращена только функцией poptGetNextOpt.
POPT_ERROR_OPTSTOODEEP	Совокупность замещений имени параметра имеет большую глубину вложений. На данный момент popt отслеживает параметры только до 10 уровня, чтобы избежать возникновения бесконечной рекурсии. Эту ошибку возвращает только функция poptGetNextOpt.
POPT_ERROR_BADQUOTE	В строке, прошедшей синтаксический анализ, было обнаружено несоответствие кавычек (например, была обнаружена только одна одинарная кавычка). Эту ошибку могут возвращать функции poptParseArgvString, poptReadConfigFile и poptReadDefaultConfig.
POPT_ERROR_BADNUMBER	Преобразование строки в число (int или long) не было выполнено вследствие того, что строка содержит нецифровые символы. Эта ошибка возникает в том случае, когда функция poptGetNextOpt обрабатывает аргумент типа РOРТ_ARG_INT или POPT_ARG_LONG.
POPT_ERROR_OVERFLOW	Преобразование из строки в число не было выполнено вследствие того, что число было слишком большим или слишком маленьким. Подобно ошибке POPT_ERROR_BADNUMBER, эта ошибка может возникнуть только в том случае, если функция poptGetNextOpt обрабатывает аргумент типа РОРТ_ARG_INT или POPT_ARG_LONG.
POPT_ERROR_ERRNO	Системный вызов был возвращен вместе с ошибкой, а errno до сих пор содержит ошибку из системного вызова. Эту ошибку могут возвращать функции poptReadConfigFile и poptReadDefaultConfig.

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

const char * poptStrerror(const int error);

Эта функция принимает код ошибки popt и возвращает строку с описанием ошибки, как и стандартная функция strerror.

char * poptBadOption(poptContext con, int flags);

Если во время выполнения функции poptGetNextOpt возникла ошибка, эта функция возвращает параметр, вызвавший ошибку. Если аргументу flags присвоено значение POPT_BADOPTION_NOALIAS, возвращается самый внешний параметр. В противном случае аргумент flags должен иметь нулевое значение, а возвращаемый параметр может быть определен посредством псевдонима.

Для большинства приложений эти две функции существенно упрощают обработку ошибок popt. Если ошибка возникает во время выполнения большинства функций, то выводится сообщение об ошибке, а функция poptStrerror возвращает строку с описанием ошибки. Если ошибка возникла во время синтаксического анализа аргумента, то код, подобный представленному ниже, отобразит информативное сообщение об ошибке.

fprintf(stderr, "%s: %s\n",
 poptBadOption(optCon, POPT_BADOPTION_NOALIAS),
 poptStrerror(rc));

26.5. Псевдонимы параметров

Одним из основных преимуществ использования библиотеки popt по сравнению с функцией getopt является возможность использования псевдонимов параметров. Благодаря ним пользователь может определить параметры, которые popt будет расширять их на другие параметры по мере их определения. Если стандартная программа grep использовала popt, то пользователи могли добавлять параметр – -text, который расширялся до – i -n -Е -2, облегчая поиск информации в текстовых файлах.

26.5.1. Определение псевдонимов

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

appname alias newoption expansion

appname представляет имя приложения, которое должно быть таким же именем, как и имя в параметре name, переданное функции poptGetContext. Благодаря этому в каждом файле можно определять псевдонимы для нескольких программ. Ключевое слово alias указывает на то, что определяется псевдоним; на данный момент конфигурационные файлы popt поддерживают только псевдонимы, однако в будущем появятся новые возможности. Следующим параметром является параметр, для которого необходимо задать псевдоним; это может быть как короткий, так и длинный параметр. Остальная часть строки определяет расширение псевдонима. Синтаксический анализ строки выполняется по аналогии с командой оболочки, в которой в качестве кавычек можно использовать символы \, " и '. Если последним символом строки будет обратная косая черта, то следующая строка в файле трактуется как логическое продолжение строки, содержащей этот символ, как и в оболочке.

Следующий элемент добавляет параметр – -text в команду grep, как было предложено в начале этого раздела.

grep alias --text -i -n -E -2

26.5.2. Разрешение псевдонимов

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

int poptReadDefaultConfig(poptContext con, int flags);

Эта функция считывает псевдонимы из /etc/popt и файла .popt в домашнем каталоге пользователя. На данный момент flags должен иметь нулевое значение, поскольку он зарезервирован только для будущего использования.

int poptReadConfigFile(poptContext con, char * fn);

Файл, определяемый посредством fn, открывается и анализируется как конфигурационный файл popt. Это позволяет программам использовать конфигурационные файлы конкретных программ.

int poptAddAlias(poptContext con, struct poptAlias alias, int flags);

В некоторых случаях в программах необходимо определять псевдонимы, не читая их из конфигурационного файла. Эта функция добавляет новый псевдоним в содержимое. Аргумент flags должен иметь нулевое значение, и в настоящий момент он зарезервирован только для будущего использования. Новый псевдоним определяется как struct poptAlias следующим образом:

struct poptAlias {
 char * longName; /* может быть NULL */
 char shortName; /* может быть '\0' */
 int argc;
 char ** argv; /*должна быть возможность освобождения с помощью free*/
};

Первые два элемента, longName и shortName, определяют параметр, для которого вводится псевдоним. Два последних аргумента, argc и argv, определяют разворачивание, которое будет использовано при обнаружении псевдонима параметра.