Майкл Джонсон - Разработка приложений в среде 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()*/

};

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

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

#include

int poptParseArgvString(char * s, int * argcPtr, char *** argvPtr);

Строка sразбирается в массив argv. Целочисленное значение, на которое указывает второй параметр, argcPtr, содержит количество проанализированных элементов, а указатель, на который ссылается последний параметр, указывает на вновь созданный массив. Размещение массива осуществляется динамически; после того как приложение завершит работу с массивом, необходимо вызвать функцию free().

Массив argvPtr, созданный функцией poptParseArgvString(), подходит для прямой передачи функции poptGetContext() [187] Часто в подобных случаях удобно использовать POPT_CONTEXT_KEEP_FIRST . .

Некоторые приложения реализуют эквивалент псевдонимов параметров, однако для этого им необходима специальная логика. Функция poptStuffArgs()позволяет приложению вставлять новые аргументы в текущую структуру poptContext.

#include

int poptStuffArgs(poptContext con, char ** argv);

Передаваемый массив argvдолжен иметь указатель NULLв качестве своего последнего элемента. Когда функция poptGetNextContext()будет вызвана в следующий раз, то анализироваться будут сначала "заполненные" аргументы. Библиотека popt возвращает обычные аргументы после того, как закончатся все "заполненные".

Библиотека poptиспользуется для обработки параметров во многих примерах из других глав книги. Простая реализация grepпредставлена в главе 23, a robin— в главе 16. Обе реализации предлагают хорошие примеры использования библиотеки poptв большинстве приложений.