Server for Information Technologies Сервер поддерживается
Центром Информационных Технологий
(095) 932-9212, 932-9213, 939-0783
E-mail: info@citforum.ru
Сервер содержит море(!) аналитической информации CIT Forum CD-ROM

GETOPTS(1)

НАЗВАНИЕ
getopts - разбор опций команды

СИНТАКСИС

  getopts цепочка_опций имя [аргумент ...]

ОПИСАНИЕ
Команда getopts используется shell-процедурами для разбора позиционных параметров и проверки опций на допустимость. Команда getopts поддерживает все применимые правила стандартного синтаксиса команд [см. intro(1), правила 3-10].

Цепочка_опций должна содержать флаги, которые будут распознаваться shell-процедурой, использующей getopts. Если за флагом следует двоеточие, то предполагается, что опция имеет аргумент или группу аргументов, которые должны отделяться от флага пробелами или табуляциями.

После каждого вызова getopts помещает следующую опцию в переменную имя, а номер аргумента, который должен быть обработан следующим, - в переменную OPTIND. Всегда, когда запускается shell или shell-процедура, OPTIND получает значение 1.

Если опции требуется аргумент, то getopts помещает его в переменную OPTARG.

Если встретилась некорректная опция, то в переменную имя помещается ?.

Если опции кончились, getopts возвращает ненулевой код завершения. Можно использовать специальную опцию --, чтобы отметить конец опций.

По умолчанию команда getopts разбирает позиционные параметры вызвавшей ее shell-процедуры, но если указать дополнительные аргументы, то getopts будет разбирать их.

ПРИМЕР
Следующий фрагмент shell-процедуры cmd показывает, как можно обработать аргументы команды, допускающей опции a и b, а также опцию o, которая должна иметь аргумент:

  while getopts abo: c
  do
  case $c in
  a | b) FLAG=$c;;
  o)  OARG=$OPTARG;;
  ?)  echo $USAGE
    exit 2;;
  esac
  done
  shift `expr $OPTIND - 1`
При такой обработке следующие строки оказываются эквивалентными:
  cmd -a -b -o "xxx z yy" file
  cmd -a -b -o "xxx z yy" -- file
  cmd -ab -o xxx,z,yy file
  cmd -ab -o "xxx z yy" file
  cmd -o xxx,z,yy -b -a file

ПРИМЕЧАНИЯ
Утверждение о эквивалентности предыдущих строк не вполне верно:

  1. В последней строке опции b и a идут в ином порядке, чем в предыдущих, и так как в данном примере эти опции помещаются в одну переменную FLAG, то при обработке последней строки окончательное значение этой переменной окажется не таким, как в предыдущих строках.

  2. В тех строках, в которых аргумент опции o задан в виде "xxx z yy", OARG примет значение xxx z yy, а в тех строках, где аргумент опции o задан как xxx,z,yy, OARG будет равен xxx,z,yy.

ФАЙЛЫ

 	/usr/bin/getopt   Старая версия программы разбора
				опций.
	/usr/lib/getoptcvt  Программа перевода shell-проце-
				дур, использовавших getopt, на
				getopts.

СМ. ТАКЖЕ
gutil(1G), intro(1), sh(1). getopt(3C) в Справочнике программиста.

ДИАГНОСТИКА
Команда getopts выводит сообщение об ошибке в стандартный протокол, когда встречается опция, не включенная в цепочку_опций.

ПРЕДОСТЕРЕЖЕНИЯ
Хотя текущая реализация getopts допускает некоторые отступления от правил, задающих синтаксис команд [см. intro(1)], этим не следует пользоваться, так как подобные возможности могут не поддерживаться в следующих версиях системы. Пусть, как и в ПРИМЕРЕ, a и b - опции без аргументов, а опции o требуется аргумент:

  cmd -aboxxx file
Здесь нарушено правило 5: опция с аргументом не должна быть в одной группе с остальными опциями.
  cmd -ab -oxxx file
Нарушено правило 6: после опции, которой требуется аргумент, должен быть пробел или табуляция.

Изменение значения переменной OPTIND или разбор различных наборов аргументов могут привести к непредсказуемому результату.

Comments: info@citmgu.ru
Designed by Andrey Novikov
Copyright © CIT
Обновлено: 13.03.2015