Программирование для Linux. Профессиональный подход - страница 11

.

В документе GNU Coding Standards перечислены имена некоторых наиболее часто используемых опций командной строки. При написании GNU-программ рекомендуется сверяться с этим документом. Пользователям удобно работать с программами, у которых много общих черт. Получить доступ к упомянутому документу в большинстве Linux-систем позволяет команда

>% info "(standards)User Interfaces"

Синтаксический анализ аргументов командной строки — утомительная задача. К счастью. в GNU-библиотеке языка С есть функция >getopt_long(), упрощающая ее решение. Эта функция понимает как короткие, так и длинные опции. Ее объявление находится в файле >.

Предположим, требуется написать программу, которая поддерживает три опции (табл. 2.1).

Таблица 2.1. Опции тестовой программы

Кроме того, программе могут быть переданы дополнительные аргументы, задающие имена входных файлов

Функции >getopt_long() нужно передать две структуры. Первая — это строка с описанием возможных коротких опций (каждая из них представлена одной буквой). Если опция предполагает наличие аргумента, после нее ставится двоеточие. В нашем случае строка будет иметь вид >ho:v. Это говорит о том, что программа поддерживает опции >-h, >-о и >-v, причем для второй из них требуется аргумент.

Список возможных длинных опций задается в виде массива структур >option. Каждый элемент массива соответствует одной опции и состоит из четырех полей. Чаще всего первое поле содержит имя опции (строка символов без ведущих дефисов), второе  — 1, если опция принимает аргумент, и 0 — в противном случае: третье — >NULL; четвертое — символьная константа, задающая короткий эквивалент данной длинной опции. Последний элемент массива должен содержать одни нули. Наш массив будет выглядеть так:

>const struct option long_options[] = {

> { "help",    0, NULL, 'h' },

> { "output",  1, NULL, 'o' },

> { "verbose", 0, NULL, 'v' },

> { NULL,      0, NULL, 0 }

>};

Функции >getopt_long() передаются также параметры >argc и >argv функции >main(). Ниже перечислены особенности ее работы.

■ При каждом вызове функция >getopt_long() анализирует очередную опцию, возвращая букву, которая соответствует короткому эквиваленту опции. При отсутствии опций возвращается -1.

■ Обычно функция >getopt_long() вызывается в цикле для обработки всех опций командной строки. Выбор конкретной опции осуществляется посредством конструкции >switch.

■ Если опция >getopt_long() обнаруживает неправильную опцию (т.е. она не указана в списке коротких и длинных опций), она выводит сообщение об ошибке и возвращает символ >? (знак вопроса). В ответ на это большинство программ завершает свою работу, обычно отображая справку по работе с программой.

■ При обработке опции, имеющей аргумент, в глобальную переменную >optarg помещается указатель на строку с содержимым аргумента.

■ Когда функция >getopt_long() завершает анализ опций, в глобальную переменную >optind записывается индекс того элемента массива >argv, в котором содержится первый аргумент, не являющийся опцией.

В листинге 2.2 приведен пример обработки аргументов программы с помощью функции >getopt_long().

>#include

>#include

>#include

>/* Имя программы. */

>const char* program_name;

>/* Вывод информации об использовании программы в поток STREAM

>   (обычно stdout или stderr) и завершение работы с выдачей кода

>   EXIT_CODE. Возврат в функцию main() не происходит */

>void print_usage(FILE* stream, int exit_code) {

> fprintf(stream, "Usage: %s options [ inputfile ... ]\n",

>  program_name);

> fprintf(stream,

>  " -h --help    Display this usage

>                 information.\n"

>  " -о --output  filename Write output to file.\n"

>  " -v --verbose Print verbose messages.\n");

> exit(exit_code);

>}

>/* Точка входа в основную программу, параметр ARGC содержит размер

>   списка аргументов; параметр ARGV -- это массив указателей