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

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));

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

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

appname alias newoption expansion

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

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

grep alias --text -i -n -E -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()*/