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

Библиотека poptявляется в высшей степени доступной и может работать на любой POSIX-платформе. Самую последнюю версию библиотеки можно найти по адресу ftp://ftp.rpm.org/pub/rpm. Библиотека poptобладает целым рядом функциональных возможностей, не упоминаемых в этой главе; их описание можно найти на man-странице для popt.

Библиотека poptможет распространяться либо под лицензией General Public License GNU, либо под лицензией Library General Public License GNU.

Приложения передают библиотеке poptинформацию о своих параметрах командной строки через массив структур struct poptOption.

#include

struct poptOption {

const char * longName; /* может иметь значение NULL */

char shortName; /* может иметь значение '\0' */

int argInfo;

void * arg; /* зависит от argInfo */

int val; /*0 означает не возвращаться, а просто обновить флаг*/

char * descrip; /* необязательное описание параметра */

char * argDescrip; /* необязательное описание аргумента */

};

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

Элемент argInfoсообщает библиотеке poptо том, какой тип аргумента ожидается после параметра. Если не ожидается никакого параметра, будет использоваться значение РОPT_ARG_NONE. Остальные допустимые значения перечислены в табл. 26.1 [182] Те, кто знаком с функцией getopt() , заметят, что argInfo является единственным обязательным членом структуры struct poptOption , который отличается от члена в таблице аргументов getoptlong() . Благодаря этому сходству существенно упрощается переход от getoptlong() к popt . .

Таблица 26.1. Типы аргументов popt

Следующий элемент, arg, позволяет библиотеке poptобновлять переменные в программе автоматически в случае использования параметра. Если argимеет значение NULL, то он будет проигнорирован, и poptне будет выполнять никаких действий. В противном случае он будет указывать на переменную, тип которой задан в правой колонке табл. 26.1.

Если параметр не принимает аргументов ( argInfoимеет значение POPT_ARG_NONE), то переменная, на которую указывает arg, получает единичное значение при использовании параметра. Если параметр принимает аргумент, то значение переменной, на которую указывает arg, обновляется до значения аргумента. Аргументы POPT_ARG_STRINGмогут принимать любую строку, а аргументы POPT_ARG_INT, POPT_ARG_LONG, POPT_ARG_FLOATи POPT_ARG_DOUBLEпреобразуются в соответствующий тип, при этом, если преобразование не удастся выполнить, будет сгенерирована ошибка.

Если используется значение POPT_ARG_VAL, то никаких аргументов не ожидается. Вместо этого poptскопирует целочисленное значение valв адрес, на который указывает arg. Это будет полезно в том случае, когда в программе имеется набор взаимно исключающих аргументов, и выбор падает на последний указанный аргумент. Определяя различные значения valдля каждого параметра, когда член argкаждого параметра будет указывать на одно и то же целочисленное значение, и, определяя для каждого из них значение POPT_ARG_VAL, можно легко узнать, какой из этих параметров был определен последним. Если будет задано более одного параметра, то сгенерировать ошибку не удастся.

Член valустанавливает значение, возвращаемое функцией проверки синтаксиса poptпри обнаружении параметра, если только не используется значение POPT_ARG_VAL. Если значение будет равно нулю, функция проверки синтаксиса продолжит проверку следующего аргумента командной строки, и не будет возвращать результат.