GETOPT(3C) GETOPT(3C) НАЗВАНИЕ getopt - разбор опций команды СИНТАКСИС |int getopt (argc, argv, optstring) |int argc; |char **argv, *optstring; | |extern char *optarg; | |extern int optind, opterr; ОПИСАНИЕ Функция getopt возвращает очередной флаг из массива argv, соответствующий какой-либо букве в цепочке optstring. Функция getopt поддерживает все правила стандартного синтаксиса команд [см. intro(1), правила 3-10]. Чтобы новые команды следовали этим правилам, для разбора позиционных параметров и проверки допустимости опций следует использовать утилиту getopts(1) или опи- сываемую функцию getopt. Цепочка optstring должна содержать флаги, которые будут распознаваться программой, использующей getopt. Если за флагом следует двоеточие, то предполагается, что опция имеет аргумент или группу аргументов, отделенных от флага пробелами или табуляциями. В переменную optarg помещается указатель на начало ар- гумента распознанной опции. После каждого вызова функция getopt помещает во внешнюю переменную optind индекс того элемента массива argv, который должен обрабатываться следующим. Значение пере- менной optind до первого обращения к функции getopt равно 1. Когда все опции обработаны (то есть встретился первый из аргументов, не входящих в состав опций), результат функции getopt равен -1. Можно использовать специальную опцию --, чтобы отметить конец опций. Когда она встре- тится при разборе, будет возвращено значение -1, а сама опция -- будет пропущена. ДИАГНОСТИКА Функция getopt выдает сообщение об ошибке в стандартный протокол и возвращает вопросительный знак ?, когда встречается флаг, не входящий в цепочку optstring, или не оказывается аргумента у опции, требующей аргумент. Выдача сообщения об ошибке может быть подавлена, для чего переменной opterr следует присвоить 0. ПРИМЕР Следующий фрагмент программы показывает, как можно об- работать аргументы команды, допускающей взаимоисключаю- щие опции a и b, а также опцию o, которая должна иметь аргумент: |main (argc, argv) |int argc; |char **argv; |{ | int c; | extern char *optarg; | extern int optind; | ... | while ((c=getopt (argc,argv,"abo:")) != -1) | switch (c) { | case 'a': | if (bflg) | errflg++; | else | aflg++; | break; | case 'b': | if (aflg) | errflg++; | else | bproc (); | break; | case 'o': | ofile = optarg; | break; | case '?': | errflg++; | } | if (errflg) { | (void) fprintf (stderr, "usage: ... "); | exit (2); | } | for ( ; optind < argc; optind++) { | if (access (argv [optind], 4)) { | ... |} ПРЕДОСТЕРЕЖЕНИЯ Хотя текущая реализация функции getopt допускает неко- торые отступления от правил, задающих синтаксис команд [см. intro(1)], этим не следует пользоваться, так как подобные возможности могут не поддерживаться в следую- щих версиях системы. Пусть, как и в ПРИМЕРЕ, a и b - опции без аргументов, а опции o требуется аргумент. Рассмотрим два типичных отступления от правил: |cmd -aboxxx file Здесь нарушено правило 5: опция с аргументом не должна быть в одной группе с остальными опциями. |cmd -ab -oxxx file Нарушено правило 6: после опции, которой требуется ар- гумент, должен быть пробел или табуляция. Изменение значения переменной optind или вызовы функции getopt с различными значениями argv могут привести к непредсказуемым результатам. СМ. ТАКЖЕ getopts(1), intro(1) в Справочнике пользователя.