Для большинства приложений эти две функции существенно упрощают обработку ошибок 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, определяют разворачивание, которое будет использовано при обнаружении псевдонима параметра.
26.6. Синтаксический анализ строк аргументов
Хотя библиотека popt обычно используется для синтаксического анализа аргументов, уже разделенных на массив вида argv, в некоторых программах необходимо анализировать синтаксис строк, формат которых идентичен командным строкам. Для этой цели popt предлагает функцию, которая анализирует синтаксис строки в виде массива строки, руководствуясь правилами, подобными обычному синтаксическому анализу в оболочке.
#include <popt.h>
int poptParseArgvString(char * s, int * argcPtr, char *** argvPtr);
Строка s разбирается в массив argv. Целочисленное значение, на которое указывает второй параметр, argcPtr, содержит количество проанализированных элементов, а указатель, на который ссылается последний параметр, указывает на вновь созданный массив. Размещение массива осуществляется динамически; после того как приложение завершит работу с массивом, необходимо вызвать функцию free().
Массив argvPtr, созданный функцией poptParseArgvString(), подходит для прямой передачи функции poptGetContext()[187].
26.7. Обработка дополнительных аргументов
Некоторые приложения реализуют эквивалент псевдонимов параметров, однако для этого им необходима специальная логика. Функция poptStuffArgs() позволяет приложению вставлять новые аргументы в текущую структуру poptContext.
#include <popt.h>
int poptStuffArgs(poptContext con, char ** argv);
Передаваемый массив argv должен иметь указатель NULL в качестве своего последнего элемента. Когда функция poptGetNextContext() будет вызвана в следующий раз, то анализироваться будут сначала "заполненные" аргументы. Библиотека popt возвращает обычные аргументы после того, как закончатся все "заполненные".
26.8. Пример приложения
Библиотека popt используется для обработки параметров во многих примерах из других глав книги. Простая реализация grep представлена в главе 23, a robin — в главе 16. Обе реализации предлагают хорошие примеры использования библиотеки popt в большинстве приложений.
RPM, популярная программа для управления пакетами Linux, интенсивно использует функциональные возможности библиотеки popt. Многие из ее аргументов командной строки реализованы через псевдонимы popt, что делает RPM превосходным примером применения преимуществ popt[188]. Более подробную информацию о RPM доступна по адресу http://www.rpm.org.
188
Первоначально библиотека popt была реализована для RPM, и многие параметры запросов RPM реализованы в виде простых макросов popt.